ChatGPT WebSearch MCP
A local MCP stdio server that provides access to the OpenAI (ChatGPT) API for Claude Code and other MCP clients. Supports models with web search capabilities.
Usage
Claude Code
$ claude mcp add chatgpt-websearch \
-s user \ # If you omit this line, it will be installed in the project scope
-e OPENAI_API_KEY=your-api-key \
-- npx @nekobato/chatgpt-websearch-mcp
Or configure in settings
{
"mcpServers": {
"chatgpt-websearch": {
"command": "npx",
"args": ["@nekobato/chatgpt-websearch-mcp"],
"env": {
"OPENAI_API_KEY": "your-api-key",
...
},
},
},
}
Environment Variables
The following environment variables can be used to set default values:
OPENAI_API_KEY(required): Your OpenAI API keyOPENAI_DEFAULT_MODEL(optional): Default model to use (default: gpt-5)REASONING_EFFORT(optional): Default reasoning effort level for reasoning models (minimal|low|medium|high)SEARCH_CONTEXT_SIZE(optional): Default verbosity level (low|medium|high)OPENAI_MAX_RETRIES(optional): Default maximum retry attempts (default: 3)OPENAI_API_TIMEOUT(optional): Default API timeout in milliseconds. If not set, auto-adjusts based on effort level:minimal/low: 60000 (1 minute)medium: 120000 (2 minutes)high: 300000 (5 minutes)
API
MCP Tools
ask_chatgpt: Send a prompt to ChatGPT and receive a responseprompt(required): The prompt to sendmodel(optional): The model to use (default: from OPENAI_DEFAULT_MODEL env var or gpt-5)system(optional): System prompt to set context and behaviortemperature(optional): Temperature for response generation (0-2, default: 0.7) - Not available for reasoning modelseffort(optional): Reasoning effort level (minimal|low|medium|high, default: from REASONING_EFFORT env var) - For reasoning models onlyverbosity(optional): Output verbosity (low|medium|high, default: from SEARCH_CONTEXT_SIZE env var) - For reasoning models onlymaxTokens(optional): Maximum output tokensmaxRetries(optional): Maximum API retry attempts (default: from OPENAI_MAX_RETRIES env var or 3)timeoutMs(optional): Request timeout in milliseconds. Auto-adjusts based on effort level (high=300s, medium=120s, low/minimal=60s)useStreaming(optional): Force streaming mode to prevent timeouts. Auto-enabled for medium/high effort reasoning models
Development
Requirements
- Node.js 22+
- An OpenAI API key in
OPENAI_API_KEY
Commands
# Install dependencies
pnpm install
# Run in development mode
pnpm dev
# Build for production
pnpm build
# Run tests
pnpm test
# Lint code
pnpm lint
# Format code
pnpm format
License
MIT License