MCP.so
Sign In

🔎 GPT Researcher

@assafelovic

RepositoryHomepage

About 🔎 GPT Researcher

An autonomous agent that conducts deep research on any data using any LLM providers

#python#search#agent#automation#research#ai#mcp#webscraping#llms#mcp-server#deepresearch

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "gpt-researcher": {
      "command": "npx",
      "args": [
        "skills",
        "add",
        "assafelovic/gpt-researcher"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is 🔎 GPT Researcher?

GPT Researcher is an open deep research agent designed for web and local research on any given task. It produces detailed, factual, unbiased research reports with citations and addresses misinformation, speed, determinism, and reliability. The server integrates with MCP clients like Claude to extend deep research capabilities.

How to use 🔎 GPT Researcher?

Install via pip (pip install gpt-researcher) or clone the repository, set OPENAI_API_KEY and TAVILY_API_KEY environment variables, then run python -m uvicorn main:app --reload. To use as a Claude Skill, run npx skills add assafelovic/gpt-researcher. For MCP integration, set RETRIEVER=tavily,mcp and pass mcp_configs to GPTResearcher.

Key features of 🔎 GPT Researcher

  • Generate detailed research reports using web and local documents.
  • Smart image scraping and AI-generated inline images.
  • Aggregate over 20 sources for objective conclusions.
  • Deep Research with tree-like exploration and concurrent processing.
  • JavaScript-enabled web scraping and memory/context maintenance.
  • Export reports to PDF, Word, and other formats.

Use cases of 🔎 GPT Researcher

  • Conduct objective research on any topic with cited sources.
  • Combine web search with local documents for tailored reports.
  • Integrate deep research into AI assistants like Claude.
  • Automate generation of long-form reports (>2,000 words) with inline visuals.

FAQ from 🔎 GPT Researcher

What API keys are required?

You need OPENAI_API_KEY and TAVILY_API_KEY. For AI-generated images, also set GOOGLE_API_KEY and IMAGE_GENERATION_ENABLED=true. Optional keys are LANGCHAIN_API_KEY and GITHUB_TOKEN for MCP GitHub integration.

Can I use local or custom LLM models?

Yes, set OPENAI_BASE_URL to your custom API base URL (e.g., for local models or other providers). Deep Research uses models like o3-mini by default.

Does 🔎 GPT Researcher support MCP?

Yes, it supports MCP integration via the RETRIEVER=tavily,mcp environment variable. You can connect to data sources like GitHub repositories, databases, and custom APIs by providing mcp_configs.

How long does a deep research task take?

Deep Research takes approximately 5 minutes per research and costs about $0.4 per research using o3-mini with "high" reasoning effort, as stated in the documentation.

Can I research local documents?

Yes, set DOC_PATH to the folder containing your documents (PDF, plain text, CSV, Excel, Markdown, PowerPoint, Word) and select "My Documents" in the frontend or set report_source to "local" in the PIP package.

Frequently asked questions

What API keys are required?

You need `OPENAI_API_KEY` and `TAVILY_API_KEY`. For AI-generated images, also set `GOOGLE_API_KEY` and `IMAGE_GENERATION_ENABLED=true`. Optional keys are `LANGCHAIN_API_KEY` and `GITHUB_TOKEN` for MCP GitHub integration.

Can I use local or custom LLM models?

Yes, set `OPENAI_BASE_URL` to your custom API base URL (e.g., for local models or other providers). Deep Research uses models like `o3-mini` by default.

Does 🔎 GPT Researcher support MCP?

Yes, it supports MCP integration via the `RETRIEVER=tavily,mcp` environment variable. You can connect to data sources like GitHub repositories, databases, and custom APIs by providing `mcp_configs`.

How long does a deep research task take?

Deep Research takes approximately 5 minutes per research and costs about $0.4 per research using `o3-mini` with "high" reasoning effort, as stated in the documentation.

Can I research local documents?

Yes, set `DOC_PATH` to the folder containing your documents (PDF, plain text, CSV, Excel, Markdown, PowerPoint, Word) and select "My Documents" in the frontend or set `report_source` to "local" in the PIP package.

Comments

Basic information

Category

AI & Agents

License

Apache-2.0

Transports

stdio

Publisher

assafelovic

More AI & Agents MCP servers

Shell and Coding agent for Claude and other mcp clients

rusiaaman

Shell and coding agent on mcp clients

666

MCP Client for Ollama (ollmcp)

jonigl

Harness the power of local LLMs with this TUI MCP Client for Ollama. Featuring all core MCP primitives (tools, prompts, resources), agent mode, multi-server, model switching, streaming responses, human-in-the-loop, thinking mode, model params config, system prompts, and saved pre

768

MCP-NixOS - Because Your AI Assistant Shouldn't Hallucinate About Packages

utensils

MCP-NixOS - Model Context Protocol Server for NixOS resources

739

Perplexity Ask MCP Server

ppl-ai

The official MCP server implementation for the Perplexity API Platform

2.4K

欢迎来到 智言平台

Shy2593666979

AgentChat 是一个基于 LLM 的智能体交流平台，内置默认 Agent 并支持用户自定义 Agent。通过多轮对话和任务协作，Agent 可以理解并协助完成复杂任务。项目集成 LangChain、Function Call、MCP 协议、RAG、Memory、HITL、Skill、Milvus 和 ElasticSearch 等技术，实现高效的知识检索与工具调用，使用 FastAPI 构建高性能后端服务。

797