OpenRouter Agents MCP Server

A multi-agent research MCP server + mini client adapter - orchestrates a net of async agents or streaming swarm to conduct ensemble consensus-backed

Local serverstdio

What is the OpenRouter Agents MCP server?

A multi-agent research MCP server + mini client adapter - orchestrates a net of async agents or streaming swarm to conduct ensemble consensus-backed research. Each task builds its own indexed pglite database on the fly in web assembly. That is what the openrouter agents mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.

The short version

Production MCP server for multi-agent AI research. Plan, parallelize, synthesize.

Getting it running

Installation goes through your MCP client rather than a global install: point it at @terminals-tech/openrouter-agents on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

The tools it exposes

The server publishes 14 tools. What each one is for:

  • research — Async research (returns job_id)
  • conduct_research — Sync research with streaming
  • batch_research — Parallel batch queries
  • research_follow_up — Context-aware follow-up
  • agent — Unified entrypoint (auto-routes)
  • search — Hybrid BM25+vector search
  • retrieve — Index or SQL query
  • query — SQL SELECT with params
  • get_report — Get report by ID
  • history — List recent reports
  • checkpoint — Named save points
  • fork_session — Create alternate timeline

What it needs from you

Configuration is passed through the environment: OPENROUTER_API_KEY, INDEXER_ENABLED. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch OpenRouter Agents.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

How it compares

Plenty of database access servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. OpenRouter Agents's toolset — research, conduct_research, batch_research and 11 more — is a fair guide to whether it matches your workflow. It is maintained by wheattoast11; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Available tools

ToolWhat it does
researchAsync research (returns job_id)
conduct_researchSync research with streaming
batch_researchParallel batch queries
research_follow_upContext-aware follow-up
agentUnified entrypoint (auto-routes)
searchHybrid BM25+vector search
retrieveIndex or SQL query
querySQL SELECT with params
get_reportGet report by ID
historyList recent reports
checkpointNamed save points
fork_sessionCreate alternate timeline
graph_traverseExplore knowledge graph
graph_clustersFind node clusters

How to install the OpenRouter Agents MCP server

{
  "mcpServers": {
    "openrouter-agents": {
      "command": "npx",
      "args": ["@terminals-tech/openrouter-agents", "--stdio"],
      "env": {
        "OPENROUTER_API_KEY": "${OPENROUTER_API_KEY}",
        "INDEXER_ENABLED": "true"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
OPENROUTER_API_KEYCredential the server authenticates with.Yes
INDEXER_ENABLEDConfiguration value read at startup.Optional

Example prompts to try

  • Use OpenRouter Agents to research.
  • Use OpenRouter Agents to conduct research.
  • Use OpenRouter Agents to batch research.

Frequently asked questions

STDIO is the default transport per MCP spec. Use the `--http` flag explicitly for HTTP mode.