o3-search MCP

o3-search-mcp

MCP server that enables the use of OpenAI's o3 model and its powerful web search capabilities. By registering it with any AI coding agent, the agent can autonomously consult with the o3 model to solve complex problems.

Use Cases

🐛 When you're stuck debugging

o3's web search can scan a wide range of sources, including GitHub issues and Stack Overflow, significantly increasing the chances of resolving niche problems. Example prompts:

> I'm getting the following error on startup, please fix it. If it's too difficult, ask o3.
> [Paste error message here]

> The WebSocket connection isn't working. Please debug it. If you don't know how, ask o3.

📚 When you want to reference the latest library information

You can get answers from the powerful web search even when there's no well-organized documentation. Example prompts:

> I want to upgrade this library to v2. Proceed while consulting with o3.

> I was told this option for this library doesn't exist. It might have been removed. Ask o3 what to specify instead and replace it.

🧩 When tackling complex tasks

In addition to search, you can also use it as a sounding board for design. Example prompts:

> I want to create a collaborative editor, so please design it. Also, ask o3 for a design review and discuss if necessary.

Also, since it's provided as an MCP server, the AI agent may decide on its own to talk to o3 when it deems it necessary, without any instructions from you. This will dramatically expand the range of problems it can solve on its own!

Installation

npx (Recommended)

Claude Code:

$ claude mcp add o3 \
	-s user \  # If you omit this line, it will be installed in the project scope
	-e OPENAI_API_KEY=your-api-key \
	-e SEARCH_CONTEXT_SIZE=medium \
	-e REASONING_EFFORT=medium \
	-e OPENAI_API_TIMEOUT=60000 \
	-e OPENAI_MAX_RETRIES=3 \
	-- npx o3-search-mcp

json:

{
  "mcpServers": {
    "o3-search": {
      "command": "npx",
      "args": ["o3-search-mcp"],
      "env": {
        "OPENAI_API_KEY": "your-api-key",
        // Optional: low, medium, high (default: medium)
        "SEARCH_CONTEXT_SIZE": "medium",
        "REASONING_EFFORT": "medium",
        // Optional: API timeout in milliseconds (default: 60000)
        "OPENAI_API_TIMEOUT": "60000",
        // Optional: Maximum number of retries (default: 3)
        "OPENAI_MAX_RETRIES": "3"
      }
    }
  }
}

Local Setup

If you want to download the code and run it locally:

git clone git@github.com:yoshiko-pg/o3-search-mcp.git
cd o3-search-mcp
pnpm install
pnpm build

Claude Code:

$ claude mcp add o3 \
	-s user \  # If you omit this line, it will be installed in the project scope
	-e OPENAI_API_KEY=your-api-key \
	-e SEARCH_CONTEXT_SIZE=medium \
	-e REASONING_EFFORT=medium \
	-e OPENAI_API_TIMEOUT=60000 \
	-e OPENAI_MAX_RETRIES=3 \
	-- node /path/to/o3-search-mcp/build/index.js

json:

{
  "mcpServers": {
    "o3-search": {
      "command": "node",
      "args": ["/path/to/o3-search-mcp/build/index.js"],
      "env": {
        "OPENAI_API_KEY": "your-api-key",
        // Optional: low, medium, high (default: medium)
        "SEARCH_CONTEXT_SIZE": "medium",
        "REASONING_EFFORT": "medium",
        // Optional: API timeout in milliseconds (default: 60000)
        "OPENAI_API_TIMEOUT": "60000",
        // Optional: Maximum number of retries (default: 3)
        "OPENAI_MAX_RETRIES": "3"
      }
    }
  }
}

Environment Variables

Environment Variable	Options	Default	Description
`OPENAI_API_KEY`	Required	-	OpenAI API Key
`SEARCH_CONTEXT_SIZE`	Optional	`medium`	Controls the search context sizeValues: `low`, `medium`, `high`
`REASONING_EFFORT`	Optional	`medium`	Controls the reasoning effort levelValues: `low`, `medium`, `high`
`OPENAI_API_TIMEOUT`	Optional	`60000`	API request timeout in millisecondsExample: `120000` for 2 minutes
`OPENAI_MAX_RETRIES`	Optional	`3`	Maximum number of retries for failed requestsThe SDK automatically retries on rate limits (429), server errors (5xx), and connection errors

Notes

To use the o3 model from the OpenAI API, you need to either raise your tier to 4 or verify your organization. If you register an API key that is not yet enabled for o3 with this MCP, calls will result in an error. Reference: https://help.openai.com/en/articles/10362446-api-access-to-o1-o3-and-o4-models

Install 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

o3-search

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.

Related MCP Servers

Google Search MCP Server
mixelpixx
A
security
F
license
A
quality
An MCP (Model Context Protocol) server that provides Google search capabilities and webpage content analysis tools. This server enables AI models to perform Google searches and analyze webpage content programmatically.
Last updated -
3
52
83
TypeScript
ReActMCP Web Search
mshojaei77
-
security
F
license
-
quality
An MCP server that integrates real-time web search capabilities into AI assistants using the Exa API, providing both basic and advanced search functionality with formatted markdown results.
Last updated -
141
Python
4o-mini-search-mcp
rebers
-
security
F
license
-
quality
An MCP server that enables AI models to search the web using OpenAI's 4o-mini Search model, allowing access to up-to-date information for just a few cents per search.
Last updated -
8
2
JavaScript
Docs-MCP
herring101
A
security
A
license
A
quality
An MCP server that allows users to efficiently search and reference user-configured documents through document listing, grep searching, semantic searching with OpenAI Embeddings, and full document retrieval.
Last updated -
4
3
Python
MIT License

View all related MCP servers

o3-search MCP

o3-search-mcp

Use Cases

🐛 When you're stuck debugging

📚 When you want to reference the latest library information

🧩 When tackling complex tasks

Installation

npx (Recommended)

Local Setup

Environment Variables

Notes

Tools

Related MCP Servers

Google Search MCP Server

ReActMCP Web Search

4o-mini-search-mcp

Docs-MCP

New MCP Servers

MCP directory API