OpenAI WebSearch MCP

OpenAI WebSearch MCP

This is a Python-based MCP server that provides OpenAI `web_search` built-in tool.

75
Stars
18
Forks
0
Releases

Overview

openai-websearch-mcp is a Python-based MCP server that exposes the OpenAI web_search tool to enable AI assistants to perform up-to-date web searches with built-in reasoning. It supports multiple OpenAI reasoning models (gpt-5, gpt-5-mini, gpt-5-nano, o3, o4-mini) and offers smart reasoning_effort defaults tailored to the use case. The server supports a multi-mode search approach: fast iterations with smaller models (gpt-5-mini) and deep research with more capable models (gpt-5). Localized results can be produced via user_location for location-based search customization. It provides complete parameter documentation for easy integration and supports flexible configuration through environment variables to simplify deployment. The README also describes quick-start installation for Claude Desktop, Cursor, and local development, along with debugging tooling including the MCP Inspector, illustrating practical deployment and troubleshooting steps. In short, openai-websearch-mcp combines reasoning-enabled web search with MCP compatibility to power AI assistants requiring current information and thoughtful analysis.

Details

Owner
ConechoAI
Language
Python
License
MIT License
Updated
2025-12-07

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

Audience

AI developersIntegrate OpenAI web search with reasoning into AI assistants needing up-to-date information.

Tags

MCPweb_searchOpenAIreasoninglocalizationPythonserverenvironment-variables