MCP server
by yoshiko-pg
Leverage OpenAI o3 Search for advanced web results, outperforming Bing AI and other engines with unrivaled AI search cap
Enables AI agents to consult OpenAI's advanced models (o3, gpt-5, o4-mini) with web search capabilities for solving complex problems beyond traditional search engines.
OpenAI o3 Search is a community-built MCP server published by yoshiko-pg that provides AI assistants with tools and capabilities via the Model Context Protocol. Leverage OpenAI o3 Search for advanced web results, outperforming Bing AI and other engines with unrivaled AI search cap It is categorized under search web.
You can install OpenAI o3 Search in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.
MIT
OpenAI o3 Search is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.
Fetch and extract information from websites automatically
Example
Research competitor pricing, scrape product reviews, monitor news mentions
Automate 5-10 hours/week of manual web research
Track website changes, new content, price updates
Example
Monitor competitor blog for new posts, track stock availability, watch for pricing changes
Stay informed without manual checking, never miss important updates
Extract structured data from multiple websites
Example
Compile product listings from 10 e-commerce sites, aggregate job postings, collect real estate data
Build datasets 100x faster than manual copying
Share your MCP server with the developer community
OpenAI o3 Search has been reliable for tool-calling workflows; the MCP profile page is a good permalink for internal docs.
OpenAI o3 Search is among the better-indexed MCP projects we tried; the explainx.ai summary tracks the official description.
OpenAI o3 Search reduced integration guesswork — categories and install configs on the listing matched the upstream repo.
According to our notes, OpenAI o3 Search benefits from clear Model Context Protocol framing — fewer ambiguous “AI plugin” claims.
Strong directory entry: OpenAI o3 Search surfaces stars and publisher context so we could sanity-check maintenance before adopting.
We evaluated OpenAI o3 Search against two servers with overlapping tools; this profile had the clearer scope statement.
Useful MCP listing: OpenAI o3 Search is the kind of server we cite when onboarding engineers to host + tool permissions.
OpenAI o3 Search has been reliable for tool-calling workflows; the MCP profile page is a good permalink for internal docs.
OpenAI o3 Search is a well-scoped MCP server in the explainx.ai directory — install snippets and categories matched our Claude Code setup.
OpenAI o3 Search is among the better-indexed MCP projects we tried; the explainx.ai summary tracks the official description.
showing 1-10 of 29
MCP server that enables the use of OpenAI's high-end models and their powerful web search capabilities. By registering it with any AI coding agent, the agent can autonomously consult with OpenAI models to solve complex problems.
<table> <tr> <td width="50%"> <a href="https://mseep.ai/app/yoshiko-pg-o3-search-mcp"> <img src="https://mseep.net/pr/yoshiko-pg-o3-search-mcp-badge.png" alt="MseeP.ai Security Assessment Badge" /> </a> </td> <td width="50%"> <a href="https://glama.ai/mcp/servers/@yoshiko-pg/o3-search-mcp"> <img src="https://glama.ai/mcp/servers/@yoshiko-pg/o3-search-mcp/badge" alt="o3-search MCP server" /> </a> </td> </tr> </table>(Although called o3 to match the MCP name, you can specify gpt-5 or o4-mini via env for the model to use)
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.
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.
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!
Claude Code:
$ claude mcp add o3 \
-s user \ # If you omit this line, it will be installed in the project scope
-e OPENAI_MODEL=o3 \ # o4-mini, gpt-5 also available
-e OPENAI_API_KEY=your-api-key \
-e SEARCH_CONTEXT_SIZE=medium \
-e REASONING_EFFORT=medium \
-e OPENAI_API_TIMEOUT=300000 \
-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: o3, o4-mini, gpt-5 (default: o3)
"OPENAI_MODEL": "o3",
// Optional: low, medium, high (default: medium)
"SEARCH_CONTEXT_SIZE": "medium",
"REASONING_EFFORT": "medium",
// Optional: API timeout in milliseconds (default: 300000)
"OPENAI_API_TIMEOUT": "300000",
// Optional: Maximum number of retries (default: 3)
"OPENAI_MAX_RETRIES": "3"
}
}
}
}
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_MODEL=o3 \ # o4-mini, gpt-5 also available
-e OPENAI_API_KEY=your-api-key \
-e OPENAI_MODEL=o3 \
-e SEARCH_CONTEXT_SIZE=medium \
-e REASONING_EFFORT=medium \
-e OPENAI_API_TIMEOUT=300000 \
-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: o3, o4-mini, gpt-5 (default: o3)
"OPENAI_MODEL": "o3",
// Optional: low, medium, high (default: medium)
"SEARCH_CONTEXT_SIZE": "medium",
"REASONING_EFFORT": "medium",
// Optional: API timeout in milliseconds (default: 300000)
"OPENAI_API_TIMEOUT": "300000",
// Optional: Maximum number of retries (default: 3)
"OPENAI_MAX_RETRIES": "3"
}
}
}
}
| Environment Variable | Options | Default | Description |
|---|---|---|---|
OPENAI_API_KEY | Required | - | OpenAI API Key |
OPENAI_MODEL | Optional | o3 | Model to use<br>Values: o3, o4-mini, gpt-5 |
SEARCH_CONTEXT_SIZE | Optional | medium | Controls the search context size<br>Values: low, medium, high |
REASONING_EFFORT | Optional | medium | Controls the reasoning effort level<br>Values: low, medium, high |
OPENAI_API_TIMEOUT | Optional | 300000 | API request timeout in milliseconds<br>Example: 300000 for 5 minutes |
OPENAI_MAX_RETRIES | Optional | 3 | Maximum number of retries for failed requests<br>The SDK automatically retries on rate limits (429), server errors (5xx), and connection errors |
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
Interact with services that don't offer APIs
Example
Check form submissions, validate website functionality, test user flows
Automate interactions with any website, even without API
Prerequisites
Time Estimate
20-40 minutes including configuration and testing
Steps
Troubleshooting
✓ Do
✗ Don't
💡 Pro Tips
Architecture
MCP server handles HTTP requests, HTML parsing, JavaScript rendering (if headless browser), and returns structured data to Claude.
Protocols
Compatibility
✓ Use when
Use for research automation, content monitoring, data aggregation from multiple sources, and when official APIs don't exist. Best for read-only information gathering.
✗ Avoid when
Avoid for sites with APIs (use API instead), sites that explicitly forbid scraping, when data is copyrighted, or for login-required content without proper authorization.