{
  "schemaVersion": "2024-11-05",
  "name": "gptr-mcp",
  "displayName": "GPT Researcher MCP",
  "version": "0.14.8",
  "description": "Model Context Protocol server exposing GPT Researcher's autonomous deep-research, quick-search, report-writing, and source-context tools. The canonical, full server is self-hosted from https://github.com/assafelovic/gptr-mcp (MIT). https://gptr.dev/api/mcp is a discovery bridge that helps agents locate and install the real server.",
  "vendor": {
    "name": "GPT Researcher",
    "url": "https://gptr.dev"
  },
  "homepage": "https://github.com/assafelovic/gptr-mcp",
  "repository": "https://github.com/assafelovic/gptr-mcp",
  "documentation": "https://docs.gptr.dev/docs/gpt-researcher/mcp-server/getting-started",
  "iconUrl": "https://gptr.dev/gptr-logo.png",
  "license": "MIT",
  "url": "https://github.com/assafelovic/gptr-mcp",
  "transports": [
    {
      "type": "stdio",
      "default": true,
      "command": "python",
      "args": ["server.py"],
      "repository": "https://github.com/assafelovic/gptr-mcp",
      "description": "Canonical self-hosted MCP server with the full tool set: deep_research / quick_search / write_report / get_research_sources / get_research_context. Requires user-supplied OPENAI_API_KEY and TAVILY_API_KEY. Recommended for Claude Desktop and Cursor."
    },
    {
      "type": "sse",
      "url": "http://localhost:8000/sse",
      "repository": "https://github.com/assafelovic/gptr-mcp",
      "description": "Self-hosted Docker SSE deployment of gptr-mcp on port 8000. Use this for n8n, web clients, and remote agent integrations. Run `docker compose up -d` in the gptr-mcp repo."
    },
    {
      "type": "streamable-http",
      "endpoint": "/api/mcp",
      "url": "https://gptr.dev/api/mcp",
      "discoveryOnly": true,
      "description": "Live discovery bridge hosted at gptr.dev. Does NOT execute research. Exposes read-only metadata tools (get_full_mcp_server, get_overview, get_quickstart, list_tools_in_full_mcp_server, get_discovery_endpoints, get_pricing) so AI agents can find, understand, and install the real self-hosted gptr-mcp. Agents should call `get_full_mcp_server` first."
    }
  ],
  "tools": [
    {
      "name": "get_full_mcp_server",
      "description": "READ FIRST. Return the GitHub URL and ready-to-paste install config for the real gptr-mcp server (live on https://gptr.dev/api/mcp).",
      "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false }
    },
    {
      "name": "get_overview",
      "description": "Return a structured overview of GPT Researcher (live on https://gptr.dev/api/mcp).",
      "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false }
    },
    {
      "name": "get_quickstart",
      "description": "Return install / quickstart instructions for python, docker, or mcp runtime (live on https://gptr.dev/api/mcp).",
      "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false }
    },
    {
      "name": "list_tools_in_full_mcp_server",
      "description": "Return the catalogue of tools available in the full self-hosted gptr-mcp (live on https://gptr.dev/api/mcp).",
      "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false }
    },
    {
      "name": "get_discovery_endpoints",
      "description": "Return the canonical agent-discovery URLs published by gptr.dev (live on https://gptr.dev/api/mcp).",
      "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false }
    },
    {
      "name": "get_pricing",
      "description": "Return the pricing summary for GPT Researcher (live on https://gptr.dev/api/mcp).",
      "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false }
    },
    {
      "name": "deep_research",
      "description": "Performs deep, multi-source web research on a topic. Plans subtopics, fetches and validates 10-30 sources, accumulates a research context, and returns a structured result. Typical latency 30-60s.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": true
      }
    },
    {
      "name": "quick_search",
      "description": "Performs a fast web search optimized for latency over depth, returning snippets with source URLs. Backed by any GPTR-supported retriever (Tavily, Bing, Google, DuckDuckGo, SearXNG).",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "write_report",
      "description": "Generate a long-form research report from accumulated research context, including inline citations.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": false
      }
    },
    {
      "name": "get_research_sources",
      "description": "Return the list of source URLs used in the most recent research run.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "get_research_context",
      "description": "Return the full accumulated research context as text, useful for further reasoning by an outer agent.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    }
  ],
  "resources": [
    {
      "name": "research_resource",
      "description": "Web resources discovered during a research task."
    }
  ],
  "prompts": [
    {
      "name": "research_query",
      "description": "Prompt template for crafting effective deep-research queries."
    }
  ],
  "auth": {
    "type": "env",
    "required": ["OPENAI_API_KEY", "TAVILY_API_KEY"],
    "notes": "Self-hosted server reads provider API keys from its environment. No credentials are sent to gptr.dev."
  },
  "registries": {
    "smithery": "https://smithery.ai/server/@assafelovic/gptr-mcp",
    "mcpSo": "https://mcp.so/server/gptr-mcp",
    "github": "https://github.com/assafelovic/gptr-mcp"
  }
}