MCPs
OpenAI WebSearch MCP Server

OpenAI WebSearch MCP Server

Intelligent web search with OpenAI reasoning model support, fully MCP-compatible.

Stars

Forks

Watchers

Issues

OpenAI WebSearch MCP Server provides advanced web search functionality integrated with OpenAI's latest reasoning models, such as gpt-5 and o3-series. It features full compatibility with the Model Context Protocol, enabling easy integration into AI assistants that require up-to-date information and contextual awareness. Built with flexible configuration options, smart reasoning effort controls, and support for location-based search customization. Suitable for environments such as Claude Desktop, Cursor, and automated research workflows.

Key Features

Full Model Context Protocol (MCP) compatibility

Intelligent web search leveraging OpenAI reasoning models

Support for multiple models (gpt-5, o3, o4-mini, gpt-5-mini, gpt-5-nano)

Smart reasoning effort control

Multi-mode search for quick or deep research

Localized and location-based search customization

Flexible environment-based configuration

Rich parameter documentation for integration

Seamless integration with Claude Desktop and Cursor

Customizable context size and effort parameters

Use Cases

Enhancing AI assistants with real-time web search and reasoning

Conducting deep research using advanced OpenAI reasoning models

Providing context-aware and localized answers to complex queries

Customizing search results based on user location

Speeding up information retrieval with quick search modes

Automating research and reporting for up-to-date topics

Integrating advanced web search into productivity tools like Cursor

Enabling flexible, environment-variable-driven deployments in organizations

Supporting multi-step reasoning for thorough analysis tasks

Empowering coding and research platforms with context-driven information

README

OpenAI WebSearch MCP Server 🔍

An advanced MCP server that provides intelligent web search capabilities using OpenAI's reasoning models. Perfect for AI assistants that need up-to-date information with smart reasoning capabilities.

✨ Features

🧠 Reasoning Model Support: Full compatibility with OpenAI's latest reasoning models (gpt-5, gpt-5-mini, gpt-5-nano, o3, o4-mini)
⚡ Smart Effort Control: Intelligent reasoning_effort defaults based on use case
🔄 Multi-Mode Search: Fast iterations with gpt-5-mini or deep research with gpt-5
🌍 Localized Results: Support for location-based search customization
📝 Rich Descriptions: Complete parameter documentation for easy integration
🔧 Flexible Configuration: Environment variable support for easy deployment

🚀 Quick Start

One-Click Installation for Claude Desktop

bash

OPENAI_API_KEY=sk-xxxx uvx --with openai-websearch-mcp openai-websearch-mcp-install

Replace sk-xxxx with your OpenAI API key from the OpenAI Platform.

⚙️ Configuration

Claude Desktop

Add to your claude_desktop_config.json:

json

{
  "mcpServers": {
    "openai-websearch-mcp": {
      "command": "uvx",
      "args": ["openai-websearch-mcp"],
      "env": {
        "OPENAI_API_KEY": "your-api-key-here",
        "OPENAI_DEFAULT_MODEL": "gpt-5-mini"
      }
    }
  }
}

Cursor

Add to your MCP settings in Cursor:

Open Cursor Settings (Cmd/Ctrl + ,)
Search for "MCP" or go to Extensions → MCP
Add server configuration:

json

{
  "mcpServers": {
    "openai-websearch-mcp": {
      "command": "uvx",
      "args": ["openai-websearch-mcp"],
      "env": {
        "OPENAI_API_KEY": "your-api-key-here",
        "OPENAI_DEFAULT_MODEL": "gpt-5-mini"
      }
    }
  }
}

Claude Code

Claude Code automatically detects MCP servers configured for Claude Desktop. Use the same configuration as above for Claude Desktop.

Local Development

For local testing, use the absolute path to your virtual environment:

json

{
  "mcpServers": {
    "openai-websearch-mcp": {
      "command": "/path/to/your/project/.venv/bin/python",
      "args": ["-m", "openai_websearch_mcp"],
      "env": {
        "OPENAI_API_KEY": "your-api-key-here",
        "OPENAI_DEFAULT_MODEL": "gpt-5-mini",
        "PYTHONPATH": "/path/to/your/project/src"
      }
    }
  }
}

🛠️ Available Tools

`openai_web_search`

Intelligent web search with reasoning model support.

Parameters

Parameter	Type	Description	Default
`input`	`string`	The search query or question to search for	Required
`model`	`string`	AI model to use. Supports gpt-4o, gpt-4o-mini, gpt-5, gpt-5-mini, gpt-5-nano, o3, o4-mini	`gpt-5-mini`
`reasoning_effort`	`string`	Reasoning effort level: low, medium, high, minimal	Smart default
`type`	`string`	Web search API version	`web_search_preview`
`search_context_size`	`string`	Context amount: low, medium, high	`medium`
`user_location`	`object`	Optional location for localized results	`null`

💬 Usage Examples

Once configured, simply ask your AI assistant to search for information using natural language:

Quick Search

"Search for the latest developments in AI reasoning models using openai_web_search"

Deep Research

"Use openai_web_search with gpt-5 and high reasoning effort to provide a comprehensive analysis of quantum computing breakthroughs"

Localized Search

"Search for local tech meetups in San Francisco this week using openai_web_search"

The AI assistant will automatically use the openai_web_search tool with appropriate parameters based on your request.

🤖 Model Selection Guide

Quick Multi-Round Searches 🚀

Recommended: gpt-5-mini with reasoning_effort: "low"
Use Case: Fast iterations, real-time information, multiple quick queries
Benefits: Lower latency, cost-effective for frequent searches

Deep Research 🔬

Recommended: gpt-5 with reasoning_effort: "medium" or "high"
Use Case: Comprehensive analysis, complex topics, detailed investigation
Benefits: Multi-round reasoned results, no need for agent iterations

Model Comparison

Model	Reasoning	Default Effort	Best For
`gpt-4o`	❌	N/A	Standard search
`gpt-4o-mini`	❌	N/A	Basic queries
`gpt-5-mini`	✅	`low`	Fast iterations
`gpt-5`	✅	`medium`	Deep research
`gpt-5-nano`	✅	`medium`	Balanced approach
`o3`	✅	`medium`	Advanced reasoning
`o4-mini`	✅	`medium`	Efficient reasoning

📦 Installation

Using uvx (Recommended)

bash

# Install and run directly
uvx openai-websearch-mcp

# Or install globally
uvx install openai-websearch-mcp

Using pip

bash

# Install from PyPI
pip install openai-websearch-mcp

# Run the server
python -m openai_websearch_mcp

From Source

bash

# Clone the repository
git clone https://github.com/yourusername/openai-websearch-mcp.git
cd openai-websearch-mcp

# Install dependencies
uv sync

# Run in development mode
uv run python -m openai_websearch_mcp

👩‍💻 Development

Setup Development Environment

bash

# Clone and setup
git clone https://github.com/yourusername/openai-websearch-mcp.git
cd openai-websearch-mcp

# Create virtual environment and install dependencies
uv sync

# Run tests
uv run python -m pytest

# Install in development mode
uv pip install -e .

Environment Variables

Variable	Description	Default
`OPENAI_API_KEY`	Your OpenAI API key	Required
`OPENAI_DEFAULT_MODEL`	Default model to use	`gpt-5-mini`

🐛 Debugging

Using MCP Inspector

bash

# For uvx installations
npx @modelcontextprotocol/inspector uvx openai-websearch-mcp

# For pip installations
npx @modelcontextprotocol/inspector python -m openai_websearch_mcp

Common Issues

Issue: "Unsupported parameter: 'reasoning.effort'" Solution: This occurs when using non-reasoning models (gpt-4o, gpt-4o-mini) with reasoning_effort parameter. The server automatically handles this by only applying reasoning parameters to compatible models.

Issue: "No module named 'openai_websearch_mcp'" Solution: Ensure you've installed the package correctly and your Python path includes the package location.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

🤖 Generated with Claude Code
🔥 Powered by OpenAI's Web Search API
🛠️ Built on the Model Context Protocol

Co-Authored-By: Claude noreply@anthropic.com

Star History

Repository Owner

ConechoAI

Organization

Repository Details

Language Python

Default Branch main

Size 99 KB

Contributors 3

License MIT License

MCP Verified Nov 12, 2025

Programming Languages

Python

100%

Related MCPs

Discover similar Model Context Protocol servers

Brave Search MCP Server

MCP integration for web, image, news, video, and local search via Brave Search API.

Implements a Model Context Protocol server that connects with the Brave Search API, enabling AI systems to perform comprehensive web, image, news, video, and local points of interest searches. Provides standardized MCP tools for various search types, each supporting advanced filtering parameters. Designed for easy integration in context-aware model interfaces such as Claude Code.

⭐ 86
MCP
mikechao/brave-search-mcp

OpenAI MCP Server

Bridge between Claude and OpenAI models using the MCP protocol.

OpenAI MCP Server enables direct querying of OpenAI language models from Claude via the Model Context Protocol (MCP). It provides a configurable Python server that exposes OpenAI APIs as MCP endpoints. The server is designed for seamless integration, requiring simple configuration updates and environment variable setup. Automated testing is supported to verify connectivity and response from the OpenAI API.

⭐ 77
MCP
pierrebrunelle/mcp-server-openai

Exa MCP Server

Fast, efficient web and code context for AI coding assistants.

Exa MCP Server provides a Model Context Protocol (MCP) server interface that connects AI assistants to Exa AI’s powerful search capabilities, including code, documentation, and web search. It enables coding agents to retrieve precise, token-efficient context from billions of sources such as GitHub, StackOverflow, and documentation sites, reducing hallucinations in coding agents. The platform supports integration with popular tools like Cursor, Claude, and VS Code through standardized MCP configuration, offering configurable access to various research and code-related tools via HTTP.

⭐ 3,224
MCP
exa-labs/exa-mcp-server

MCP ChatGPT Server

Enables direct access to OpenAI's ChatGPT API from Claude Desktop via the Model Context Protocol.

MCP ChatGPT Server runs as an MCP-compliant server, allowing users to access OpenAI's ChatGPT API seamlessly within Claude Desktop. It supports customizable model parameters, automated conversation state management, integrated web search for up-to-date information, and facilitates interactive discussions between Claude and ChatGPT. Users can configure model selection, temperature, token limits, and use their own OpenAI API keys.

⭐ 14
MCP
billster45/mcp-chatgpt-responses

mcp-server-webcrawl

Advanced search and retrieval for web crawler data via MCP.

mcp-server-webcrawl provides an AI-oriented server that enables advanced filtering, analysis, and search over data from various web crawlers. Designed for seamless integration with large language models, it supports boolean search, filtering by resource types and HTTP status, and is compatible with popular crawling formats. It facilitates AI clients, such as Claude Desktop, with prompt routines and customizable workflows, making it easy to manage, query, and analyze archived web content. The tool supports integration with multiple crawler outputs and offers templates for automated routines.

⭐ 32
MCP
pragmar/mcp-server-webcrawl

MCP Web Research Server

Bring real-time web research and Google search capabilities into Claude using MCP.

MCP Web Research Server acts as a Model Context Protocol (MCP) server, seamlessly integrating web research functionalities with Claude Desktop. It enables Google search, webpage content extraction, research session tracking, and screenshot capture, all accessible directly from Claude. The server supports interactive and guided research sessions, exposing session data and screenshots as MCP resources for enhanced context-aware AI interactions.

⭐ 284
MCP
mzxrai/mcp-webresearch

View all Alternatives

Didn't find tool you were looking for?

Search AI Tools

OpenAI WebSearch MCP Server

Key Features

Use Cases

README

OpenAI WebSearch MCP Server 🔍

✨ Features

🚀 Quick Start

One-Click Installation for Claude Desktop

⚙️ Configuration

Claude Desktop

Cursor

Claude Code

Local Development

🛠️ Available Tools

openai_web_search

Parameters

💬 Usage Examples

Quick Search

Deep Research

Localized Search

🤖 Model Selection Guide

Quick Multi-Round Searches 🚀

Deep Research 🔬

Model Comparison

📦 Installation

Using uvx (Recommended)

Using pip

From Source

👩‍💻 Development

Setup Development Environment

Environment Variables

🐛 Debugging

Using MCP Inspector

Common Issues

📄 License

🙏 Acknowledgments

Star History

Repository Owner

Repository Details

Programming Languages

Tags

Related MCPs

`openai_web_search`