This project provides an MCP server that integrates OpenAI's o3 model, specifically its web search capabilities, with AI coding agents. It enables agents to autonomously search the web for information, debug issues by referencing external resources like GitHub and Stack Overflow, and gather the latest library information, thereby enhancing their problem-solving capacity for complex tasks. The target audience includes developers and AI engineers looking to augment their AI coding agents with advanced web search and reasoning functionalities.

How It Works

The server acts as a middleware, allowing AI coding agents to interact with OpenAI's o3 model. When an agent needs to resolve a complex problem, debug an error, or find up-to-date information, it can query the o3 model through this MCP server. The o3 model then leverages its web search capabilities to find relevant information, which is fed back to the AI agent. This approach allows AI agents to go beyond their internal knowledge base and access real-time, external data, significantly improving their autonomy and effectiveness.

Quick Start & Requirements

• Installation: Recommended installation via npx by running claude mcp add o3 -s user -e OPENAI_API_KEY=your-api-key.
• Prerequisites: Requires Node.js and npm/npx. An OpenAI API key with access to o3 models is mandatory. Organization tier must be raised to 4 or verified for o3 model access.
• Environment Variables: OPENAI_API_KEY (required), SEARCH_CONTEXT_SIZE (optional, default: medium), REASONING_EFFORT (optional, default: medium), OPENAI_API_TIMEOUT (optional, default: 60000), OPENAI_MAX_RETRIES (optional, default: 3).
• Local Setup: Clone the repository, run pnpm install, and pnpm build. The local execution command uses node /path/to/o3-search-mcp/build/index.js.
• Documentation: OpenAI API access details: https://help.openai.com/en/articles/10362446-api-access-to-o1-o3-and-o4-models

Highlighted Details

• Enables AI agents to autonomously consult the o3 model for web search and problem-solving.
• Facilitates debugging by referencing external resources like GitHub issues and Stack Overflow.
• Supports staying updated with the latest library information through web searches.

Maintenance & Community

• The repository is maintained by yoshiko-pg. No specific community links (Discord, Slack) or major contributor information are provided in the README.

Licensing & Compatibility

• The license is not specified in the provided README.

Limitations & Caveats

• Access to OpenAI's o3 model is required, which may involve organizational tier upgrades or verification. Calls will fail if the API key is not enabled for o3.