deepsearch-research-agent
Enables harvesting and verification of primary literature from arXiv through the multi-engine crawling pipeline.
Integrates OpenAI's language models as an LLM backend for research synthesis, analysis, and report generation.
Enables harvesting and verification of biomedical literature from PubMed through the multi-engine crawling pipeline.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
DeepSearch Research Agent & Studio
Zero-dependency multi-source deep research agent, grounded citation graph analyzer, contradiction detector, and synthesis engine built on the Python 3.9+ standard library. Ships with a standalone offline-ready Deep Research Studio web interface on loopback port 127.0.0.1:8122, a full CLI (deepsearch), and a JSON-RPC 2.0 Model Context Protocol (MCP) server.
Engineered by 1nc0gn30 (@1nc0gn30, 1nc0gn30.si) • NullAI (nullai.tech).
Overview
Zero Runtime Dependencies: Pure Python 3.9+ standard library core (
urllib,html.parser,http.server,json,dataclasses,concurrent.futures) paired with a self-contained browser UI.Recursive Query Decomposition: Tree-of-Thought query planner (
planner.py) decomposes research questions into targeted sub-queries with configurable depth (quick,standard,deep,exhaustive).Evidence Provenance & Citation Graph: Tracks claim lineage, domain authority scores, credibility tiers, and circular citation loops (
evidence_graph.py).Dialectical Contradiction Detection: Cross-validates quantitative and qualitative assertions across sources (
contradiction_detector.py) to classify claims asVerified,Contested, orRefuted.Multi-Format Report Export: Synthesizes inline-cited Markdown, standalone HTML5, and machine-readable JSON bundles (
synthesizer.py,report_engine.py).100% Free & Open Source: Every workspace tab, citation export, CLI subcommand, and MCP tool is unlocked with zero telemetry. Optional community support is available via Buy Us a Coffee (Stripe).
Related MCP server: Multi-Agent Deep Researcher MCP
Architecture
flowchart TD
subgraph Interfaces["Client & Agent Interfaces"]
CLI["CLI (deepsearch)"]
TUI["Unicode Braille TUI (bin/deepsearch-research-agent-tui)"]
Studio["Deep Research Studio (127.0.0.1:8122)"]
MCP["MCP JSON-RPC 2.0 Server (stdio)"]
end
subgraph Pipeline["5-Stage Research Pipeline"]
Plan["Stage 1: Query Planner (planner.py)"]
Crawl["Stage 2: Adaptive Evidence Crawler (crawler.py)"]
Graph["Stage 3: Provenance & Authority Graph (evidence_graph.py)"]
Verify["Stage 4: Contradiction Detector (contradiction_detector.py)"]
Synth["Stage 5: Grounded Synthesizer & Exporter (synthesizer.py / report_engine.py)"]
end
CLI --> Plan
TUI --> Plan
Studio --> Plan
MCP --> Plan
Plan --> Crawl --> Graph --> Verify --> SynthDetailed architectural documentation is available in docs/RESEARCH_METHODOLOGY.md, docs/QUERY_PLANNING_GUIDE.md, docs/MCP_GUIDE.md, and examples/.
Quickstart
Clone and Install
git clone https://github.com/1nc0gn30/deepsearch-research-agent.git
cd deepsearch-research-agent
python3 -m pip install -e ".[dev]"Launch Local Workstation (127.0.0.1:8122)
# Lightweight static + telemetry workbench on 127.0.0.1:8122
python3 server.py --host 127.0.0.1 --port 8122
# Full REST API + Deep Research Studio server on 127.0.0.1:8122
python3 -m deepsearch_research_agent.cli serve --host 127.0.0.1 --port 8122Open http://127.0.0.1:8122 in your browser, or view the Zoth Studio v2 dossier at https://zoth.nullai.tech/tools/deepsearch-research-agent.
CLI & MCP Usage
CLI Subcommands (deepsearch)
# Inspect CLI options
deepsearch --help
# Generate a multi-stage Tree-of-Thought query plan
deepsearch plan "Fault-tolerant logical qubit scaling 2026" --depth deep --json
# Execute multi-perspective research and export Markdown / HTML / JSON
deepsearch research "Enterprise MCP agent security patterns" --depth standard --output report.md
# Fetch and extract clean text/Markdown from a URL
deepsearch fetch https://example.com
# Cross-validate claims and inspect citation provenance graphs
deepsearch corroborate --help
deepsearch provenance --help
# Run multi-OS platform diagnostics
deepsearch platform --json
# Serve Deep Research Studio + REST API on loopback port 8122
deepsearch serve --host 127.0.0.1 --port 8122ZothOS v3.4.0 CLI & Braille TUI Integration
# Unified Node/Electron launcher (delegates CLI flags or starts web mode on :8122)
node bin/deepsearch.js --help
node bin/deepsearch.js web
# Unicode U+2800 Braille TUI & JSON telemetry
python3 bin/deepsearch-research-agent-tui --json
python3 bin/deepsearch-research-agent-tui --benchmarkModel Context Protocol (MCP) Server
Start the stdio JSON-RPC 2.0 server (sample client configurations in examples/mcp-clients/):
deepsearch mcp
# or directly:
python3 -m deepsearch_research_agent.mcp_serverRegistered MCP tools:
deepsearch/deepsearch_execute— Execute end-to-end grounded multi-source research with inline citations.deepsearch_plan— Decompose a research prompt into structured sub-queries and focus perspectives.deepsearch_fetch— Retrieve and sanitize remote HTML/text documents with authority scoring.deepsearch_corroborate— Evaluate consensus vs contradiction across extracted source claims.deepsearch_evidence_graph— Construct provenance DAGs and detect circular citation loops.deepsearch_export_report— Render synthesized research into Markdown, HTML, or JSON bundles.deepsearch_get_diagnostics— Return runtime, platform, and engine health diagnostics.
REST API Endpoints
When running deepsearch serve --host 127.0.0.1 --port 8122 (or python3 -m deepsearch_research_agent.ui_server --port 8122):
Method | Endpoint | Description |
|
| Service health status ( |
|
| Multi-OS runtime and engine diagnostics |
|
| Ready-to-copy MCP JSON configs for Claude Desktop, Cursor, Cline, and Zed |
|
| Generate a structured research query plan |
|
| Execute multi-source research and consensus synthesis |
|
| Fetch and extract clean content from a target URL |
|
| Run dialectical claim corroboration and contradiction checks |
|
| Export synthesized dossier as Markdown or HTML |
|
| Export full machine-readable JSON research bundle |
Mutating POST endpoints enforce local-origin CSRF verification (127.0.0.1, localhost, ::1).
Testing & Verification
# Run full unit, example, origin-guard, and UI regression test suite
python3 -m pytest -q
# Verify CLI & TUI entrypoints
PYTHONPATH=src python3 -m deepsearch_research_agent.cli --help
PYTHONPATH=src python3 -m deepsearch_research_agent.cli platform --json
python3 bin/deepsearch-research-agent-tui --json
# Secret & PII scan
gitleaks detect --source . --no-banner --redactSupport
DeepSearch Research Agent is 100% free and open-access software with zero paywalls or feature gates. Optional community support:
Solana Tip:
GG2eQbVh8ut1BK6j1A2tz7pSySdLpD38BgyEhGcxdXoK
License
MIT License. Engineered by Neal Frazier Tech (@1nc0gn30) & NullAI Platform. See LICENSE for details.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Grounded web and Agent-network research for any MCP client: answers with cited evidence.
Machine-native research commons for agent evidence, discovery, rooms, and bounded research quests.
Shared, peer-validated knowledge archive for AI agents — search, contribute, and validate via MCP
Source-traced evidence research for AI agents. We organise the evidence; you decide.
Related MCP Servers
- FlicenseNot gradedqualityBmaintenanceEnables automated scientific paper analysis, citation credibility verification, consensus ratio calculation, and multi-hop research queries through the Model Context Protocol, integrating with MCP-compliant clients.8-
- AlicenseAqualityCmaintenanceEnables AI clients to perform autonomous multi-agent deep research through MCP tools, including deep research, quick search, and retrieval of archived Markdown reports with live web search and source citations.41MIT
- FlicenseNot gradedqualityBmaintenanceEnables AI agents and MCP clients to run deterministic deep research consensus arbitration by parsing queries, evaluating source authority and contradictions, and returning structured JSON dossiers and telemetry.8-

genpark-deep-researchofficial
FlicenseNot gradedqualityNot gradedmaintenanceEnables AI agents to perform deep research across multiple sources, arbitrating consensus while evaluating source authority and detecting contradictions. It integrates via MCP with clients like Claude Desktop and Cursor to deliver deterministic, structured research dossiers.-