research-hub-mcp

MCP server for Research Hub.

Install:

npm install -g @hci_hub/research-hub-mcp

Configure your MCP client with:

{
  "mcpServers": {
    "research-hub": {
      "command": "research-hub-mcp",
      "env": {
        "RESEARCH_HUB_AGENT_API_URL": "https://research.runzecai.com/api/agent",
        "RESEARCH_HUB_AGENT_TOKEN": "rh_xxxxx"
      }
    }
  }
}

The token is created in Research Hub at /settings. The server exposes structured tools for:

• Projects: List, get, and update project metadata, description, literature data, and level_config.
• Literature: Read/update structured literature data, patch or delete individual nodes, validate structure, mark represented sources as analyzed, and run a composite literature sync.
• Sources: List metadata, get full content (lazy loading), update analysis status, bulk update/upsert metadata, and match external/Zotero sources.
• Docs: Create, list, read, update, delete, and label project Markdown/LaTeX/text docs.
• Doc upsert: Update an existing doc by exact title or create it if missing.
• Tasks & Meetings: Create, list, and update project-related tasks and records.
• Context: Get full project snapshots for brainstorming.

For literature workflows, the key tools are:

• research_hub_project_update
• research_hub_literature_get
• research_hub_literature_update
• research_hub_literature_paper_update
• research_hub_literature_paper_delete
• research_hub_literature_node_delete
• research_hub_literature_mark_sources_analyzed
• research_hub_source_bulk_update
• research_hub_source_bulk_upsert
• research_hub_source_match
• research_hub_doc_upsert
• research_hub_literature_sync

research_hub_literature_update is a guarded full-tree write. It requires expectedUpdatedAt from research_hub_literature_get, unless force is explicitly true. Use research_hub_literature_paper_update, research_hub_literature_paper_delete, or research_hub_literature_node_delete for localized changes.

API errors are returned with structured details when the Research Hub API provides them, which helps diagnose validation errors, RLS/permission failures, invalid UUIDs, and database constraint issues.