fbettag/openai-deep-research-mcp
3.2
If you are the rightful owner of openai-deep-research-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
The OpenAI Deep Research MCP Server is a TypeScript-based server that interfaces with OpenAI's Deep Research API, enabling users to create, manage, and retrieve research requests efficiently.
OpenAI Deep Research MCP Server
A TypeScript MCP (Model Context Protocol) server that provides access to OpenAI's Deep Research API.
Features
- openai_deep_research_create: Create new research requests
- openai_deep_research_check_status: Check the status of research requests
- openai_deep_research_get_results: Retrieve completed research results with citations
Quick Start
npx github:fbettag/openai-deep-research-mcp
Quick Setup with Claude CLI
claude mcp add openai-deep-research -s user npx github:fbettag/openai-deep-research-mcp -e OPENAI_API_KEY=sk-your-openai-api-key-here
Replace sk-your-openai-api-key-here
with your actual OpenAI API key.
Claude Desktop Setup (Manual)
Add to your Claude Desktop configuration:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"openai-deep-research": {
"command": "npx",
"args": ["github:fbettag/openai-deep-research-mcp"],
"env": {
"OPENAI_API_KEY": "sk-your-openai-api-key-here"
}
}
}
}
Available Functions
Create Research Request
openai_deep_research_create({
query: "Your research question",
system_message?: "Optional guidance",
model?: "o3-deep-research-2025-06-26",
include_code_interpreter?: false
})
Check Status
openai_deep_research_check_status({
request_id: "req_123..."
})
Get Results
openai_deep_research_get_results({
request_id: "req_123..."
})
Models
o3-deep-research-2025-06-26
: Full research model (5-30 min)o4-mini-deep-research-2025-06-26
: Faster, lightweight model
Requirements
- Node.js >= 18.0.0
- OpenAI API key with Deep Research access
Development
npm install
npm run dev
License
MIT