by assafelovic · assafelovic/gpt-researcher
Autonomous research agent: give it a question, it plans searches, reads sources, and writes a cited report — callable from Claude via MCP.
GPT Researcher decomposes a research question into sub-queries, fetches web and document sources, and synthesizes a cited report. Its MCP server lets Claude offload deep research while staying in the chat.
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"gpt-researcher-mcp": {
"command": "uvx",
"args": [
"gpt-researcher-mcp"
]
}
}
}Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.
{
"mcpServers": {
"gpt-researcher-mcp": {
"command": "uvx",
"args": [
"gpt-researcher-mcp"
]
}
}
}Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.
{
"mcpServers": {
"gpt-researcher-mcp": {
"command": "uvx",
"args": [
"gpt-researcher-mcp"
]
}
}
}Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".
{
"mcpServers": {
"gpt-researcher-mcp": {
"command": "uvx",
"args": [
"gpt-researcher-mcp"
]
}
}
}Same shape as Claude Desktop. Restart Windsurf to pick up changes.
{
"mcpServers": [
{
"name": "gpt-researcher-mcp",
"command": "uvx",
"args": [
"gpt-researcher-mcp"
]
}
]
}Continue uses an array of server objects rather than a map.
{
"context_servers": {
"gpt-researcher-mcp": {
"command": {
"path": "uvx",
"args": [
"gpt-researcher-mcp"
]
}
}
}
}Add to context_servers. Zed hot-reloads on save.
claude mcp add gpt-researcher-mcp -- uvx gpt-researcher-mcpOne-liner. Verify with claude mcp list. Remove with claude mcp remove.
When to use: Question needs 20+ sources and a written summary, not 3 web hits.
Outcome: Cited multi-source report in one prompt.
Use Exa for fast lookups; GPT Researcher for deep multi-source work
| Tool | Inputs | When to call | Cost |
|---|---|---|---|
| research.run | (see docs) | Run a multi-step research task | 1 call |
| research.status | (see docs) | Check on a running task | 1 call |
search:readSend proprietary data unless self-hostingResearcher loops on same sourcesLower iteration cap; tighten the question
| Alternative | When to use it instead | Tradeoff |
|---|---|---|
| Manual web + search MCP | One-off questions | No synthesis layer |