NestDaddy

Agentic Research

io.github.TheAiSingularity/agentic-research ยท v0.1.3

Local research agent that verifies its own answers. Runs on Gemma 3 4B + Ollama, $0/query.

Connect Runs on your machine

Terminal
claude mcp add agentic-research -e OPENAI_BASE_URL=<OPENAI_BASE_URL> -e OPENAI_API_KEY=<OPENAI_API_KEY> -e MODEL_SYNTHESIZER=<MODEL_SYNTHESIZER> -e MODEL_PLANNER=<MODEL_PLANNER> -e EMBED_MODEL=<EMBED_MODEL> -e SEARXNG_URL=<SEARXNG_URL> -e LOCAL_CORPUS_PATH=<LOCAL_CORPUS_PATH> -e ENABLE_RERANK=<ENABLE_RERANK> -e ENABLE_FETCH=<ENABLE_FETCH> -- uvx agentic-research-engine==0.1.3
claude_desktop_config.json
{
  "mcpServers": {
    "agentic-research": {
      "command": "uvx",
      "args": [
        "agentic-research-engine==0.1.3"
      ],
      "env": {
        "OPENAI_BASE_URL": "<OPENAI_BASE_URL>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "MODEL_SYNTHESIZER": "<MODEL_SYNTHESIZER>",
        "MODEL_PLANNER": "<MODEL_PLANNER>",
        "EMBED_MODEL": "<EMBED_MODEL>",
        "SEARXNG_URL": "<SEARXNG_URL>",
        "LOCAL_CORPUS_PATH": "<LOCAL_CORPUS_PATH>",
        "ENABLE_RERANK": "<ENABLE_RERANK>",
        "ENABLE_FETCH": "<ENABLE_FETCH>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "mcpServers": {
    "agentic-research": {
      "command": "uvx",
      "args": [
        "agentic-research-engine==0.1.3"
      ],
      "env": {
        "OPENAI_BASE_URL": "<OPENAI_BASE_URL>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "MODEL_SYNTHESIZER": "<MODEL_SYNTHESIZER>",
        "MODEL_PLANNER": "<MODEL_PLANNER>",
        "EMBED_MODEL": "<EMBED_MODEL>",
        "SEARXNG_URL": "<SEARXNG_URL>",
        "LOCAL_CORPUS_PATH": "<LOCAL_CORPUS_PATH>",
        "ENABLE_RERANK": "<ENABLE_RERANK>",
        "ENABLE_FETCH": "<ENABLE_FETCH>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "agentic-research": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "agentic-research-engine==0.1.3"
      ],
      "env": {
        "OPENAI_BASE_URL": "<OPENAI_BASE_URL>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "MODEL_SYNTHESIZER": "<MODEL_SYNTHESIZER>",
        "MODEL_PLANNER": "<MODEL_PLANNER>",
        "EMBED_MODEL": "<EMBED_MODEL>",
        "SEARXNG_URL": "<SEARXNG_URL>",
        "LOCAL_CORPUS_PATH": "<LOCAL_CORPUS_PATH>",
        "ENABLE_RERANK": "<ENABLE_RERANK>",
        "ENABLE_FETCH": "<ENABLE_FETCH>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

NameDescription
OPENAI_BASE_URL
Optional
Any OpenAI-compatible endpoint. Default: OpenAI cloud. Use http://localhost:11434/v1 for Ollama.
OPENAI_API_KEY
Optional, secret
API key for the endpoint above. Use 'ollama' as a sentinel value when running locally against Ollama.
MODEL_SYNTHESIZER
Optional
Model identifier used for the synthesize node. Defaults to 'gpt-5-mini'; set to 'gemma3:4b' for Mac-local Ollama.
MODEL_PLANNER
Optional
Model for the plan / classify / critic / compress / verify nodes. Defaults to 'gpt-5-nano'.
EMBED_MODEL
Optional
Embedding model identifier (for retrieval + memory). Default 'text-embedding-3-small'; use 'nomic-embed-text' on Ollama.
SEARXNG_URL
Optional
Base URL of the SearXNG meta-search instance. Default http://localhost:8888.
LOCAL_CORPUS_PATH
Optional
Path to an index directory built via scripts/index_corpus.py. When set, local corpus hits augment web search.
ENABLE_RERANK
Optional
Set to '1' to enable the BAAI/bge-reranker-v2-m3 cross-encoder rerank stage. First run downloads ~560MB.
ENABLE_FETCH
Optional
Set to '0' to skip the trafilatura full-page fetch stage. Default '1'.

Details

Package[email protected] (PYPI, stdio)
First published20 Apr 2026
Last updated20 Apr 2026
Registry nameio.github.TheAiSingularity/agentic-research

More ai and media servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.