OpenAI WebSearch MCP Server

This MCP server provides access to OpenAI's websearch functionality through the Model Context Protocol. It allows AI assistants to search the web during conversations with users, providing up-to-date information that may not be available in the assistant's training data. The server can be installed and configured for use with Claude.app or Zed editor.

One click installation & Configuration

Claude

!!Can using this command auto update configure file（Recommend）

OPENAI_API_KEY=sk-xxxx uv run --with uv --with openai-websearch-mcp openai-websearch-mcp-install

sk-xxxx is your API key. You can get it from openai's open platform

Cursor

Conming soon

Windsurf

Conming soon

Available Tools

web_search - Call openai websearch as tool.
- Required arguments:
  - type (string): web_search_preview
  - search_context_size (string): High level guidance for the amount of context window space to use for the search. One of low, medium, or high. medium is the default.
  - user_location (object or null)
    - type (string): The type of location > approximation. Always approximate.
    - city (string): Free text input for the city of the user, e.g. San Francisco.
    - country (string): The two-letter ISO country code of the user, e.g. US.
    - region (string): Free text input for the region of the user, e.g. California.
    - timezone (string): The IANA timezone of the user, e.g. America/Los_Angeles.

Manual installation and configuration

Please make sure uvx is installed before installation

Add to your Claude settings:

1、Using uvx

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

2、Using pip installation

1）install openai-websearch-mcp via pip:

pip install openai-websearch-mcp

2）modify your Claude settings

"mcpServers": {
  "openai-websearch-mcp": {
    "command": "python",
    "args": ["-m", "openai_websearch_mcp"],
    "env": {
        "OPENAI_API_KEY": "your-api-key-here"
    }
  }
}

Configure for Zed

Add to your Zed settings.json:

Using uvx

"context_servers": [
  "openai-websearch-mcp": {
    "command": "uvx",
    "args": ["openai-websearch-mcp"],
    "env": {
        "OPENAI_API_KEY": "your-api-key-here"
    }
  }
],

Using pip installation

"context_servers": {
  "openai-websearch-mcp": {
    "command": "python",
    "args": ["-m", "openai_websearch_mcp"],
    "env": {
        "OPENAI_API_KEY": "your-api-key-here"
    }
  }
},

Debugging

You can use the MCP inspector to debug the server. For uvx installations:

npx @modelcontextprotocol/inspector uvx openai-websearch-mcp

Deploy Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

web_search

One click installation & Configuration，access to OpenAI's websearch functionality through the Model Context Protocol。

Related Resources

Reddit Discussion about this server

Related MCP Servers

Brave Search MCP Server
arben-adm
A
security
A
license
A
quality
Facilitates integration of Brave Search functionalities with AI assistants through the Model Context Protocol, enabling web and local searches using the Brave Search API.
Last updated -
13
MIT License
MCP Google Server
adenot
A
security
A
license
A
quality
Provides web search capabilities using Google Custom Search API, enabling users to perform searches through a Model Context Protocol server.
Last updated -
447
44
MIT License
Meilisearch MCP Server
devlimelabs
A
security
A
license
A
quality
Enables AI assistants to interact with Meilisearch via the Model Context Protocol, allowing comprehensive index, document, and search management through a standardized interface.
Last updated -
68
1
9
MIT License
o3-search MCP
yoshiko-pg
A
security
A
license
A
quality
An MCP server that enables web search capabilities using OpenAI's o3 model, allowing AI assistants to perform text-based web searches and return AI-powered results.
Last updated -
1
746
269
MIT License

View all related MCP servers

OpenAI WebSearch MCP Server