Local research agent that verifies its own answers. Runs on Gemma 3 4B + Ollama, $0/query.
Connect Runs on your machine
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
{
"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>"
}
}
}
}
{
"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>"
}
}
}
}
{
"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
| Name | Description |
|---|---|
OPENAI_BASE_URLOptional | Any OpenAI-compatible endpoint. Default: OpenAI cloud. Use http://localhost:11434/v1 for Ollama. |
OPENAI_API_KEYOptional, secret | API key for the endpoint above. Use 'ollama' as a sentinel value when running locally against Ollama. |
MODEL_SYNTHESIZEROptional | Model identifier used for the synthesize node. Defaults to 'gpt-5-mini'; set to 'gemma3:4b' for Mac-local Ollama. |
MODEL_PLANNEROptional | Model for the plan / classify / critic / compress / verify nodes. Defaults to 'gpt-5-nano'. |
EMBED_MODELOptional | Embedding model identifier (for retrieval + memory). Default 'text-embedding-3-small'; use 'nomic-embed-text' on Ollama. |
SEARXNG_URLOptional | Base URL of the SearXNG meta-search instance. Default http://localhost:8888. |
LOCAL_CORPUS_PATHOptional | Path to an index directory built via scripts/index_corpus.py. When set, local corpus hits augment web search. |
ENABLE_RERANKOptional | Set to '1' to enable the BAAI/bge-reranker-v2-m3 cross-encoder rerank stage. First run downloads ~560MB. |
ENABLE_FETCHOptional | Set to '0' to skip the trafilatura full-page fetch stage. Default '1'. |
Details
| Package | [email protected] (PYPI, stdio) |
| First published | 20 Apr 2026 |
| Last updated | 20 Apr 2026 |
| Registry name | io.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.
