Advertise
MCP.so
Sign In

OpenRouter Agents MCP Server

@wheattoast11

RepositoryHomepage

Basic information

Category

Data & Analytics

License

MIT

Transports

stdio

Author

wheattoast11

About 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. Includes semantic + hybrid search, SQL execu

#mcp#artificial-intelligence#llm#openrouter#mcp-server#modelcontextprotocol#claude-3-7-sonnet#gemini-2-5-pro-exp

OpenRouter Agents MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "openrouter-deep-research-mcp": {
      "command": "npx",
      "args": [
        "@terminals-tech/openrouter-agents",
        "--stdio"
      ]
    }
  }
}

OpenRouter Agents MCP Server tools

42

Synchronous conversational dialogue with Zero. Maintains short-term memory within the provided messages array.

Unified research tool. async=true (default) enqueues and returns {job_id}. async=false streams results synchronously like conduct_research. Example: {query: 'What is quantum computing?', costPreference: 'low', async: true}

Single entrypoint agent tool. Routes to research, follow_up, retrieve/query, or chain. Examples: {query:'AI safety'} for research, {action:'retrieve', query:'topic', k:5} for search, {chain:[{tool:'search',params:{q:'topic'}},{tool:'get_report',params:{reportId:'1'}}]} for chaining. Max depth: NaN.

Lightweight health check. Returns pong with server time; info=true adds DB/embedder/job counts.

Get job status with a compact summary by default. Use format: 'full' to include full status + events or 'events' to return only events.

Cancel a queued or running job (best-effort).

Retrieve from KB or DB. Examples: {mode:'index', query:'AI safety', k:5} or {mode:'sql', sql:'SELECT id,query FROM research_reports', explain:true}

Get current date/time. format: 'iso'|'rfc'|'epoch'.

Evaluate a simple arithmetic expression (+,-,*,/,^,(), decimals). Safe parser.

List available MCP tools with metadata. Optionally filter by query and use semantic ranking.

Semantic search over available tools. Returns ranked matches.

Execute a read-only SELECT with bound params. Example: {sql: 'SELECT * FROM research_reports WHERE id = $1', params: ['5'], explain: true}

Batch dispatch multiple research queries in a single call. Returns job IDs or waits for completion. Example: {queries: ['topic 1', 'topic 2', {query:'topic 3', costPreference:'high'}], waitForCompletion: true}

Overview

What is OpenRouter Agents MCP Server?

OpenRouter Agents MCP Server is a production-grade MCP server for multi-agent AI research and synthesis. It orchestrates parallel research agents using OpenRouter’s model API, providing planning, parallelization, and synthesis capabilities.

How to use OpenRouter Agents MCP Server?

Install via npx @terminals-tech/openrouter-agents --stdio (default STDIO transport) and set the OPENROUTER_API_KEY environment variable. Configuration can be provided via .env or .mcp.json file. For HTTP transport, add the --http flag.

Key features of OpenRouter Agents MCP Server

  • Plans, parallelizes, and synthesizes multi-agent AI research.
  • Embeds query vectors to route models without an LLM call.
  • Persistent knowledge base with PGlite and pgvector.
  • Circuit breaker for model API fault tolerance.
  • Rail Protocol for bidirectional agent communication.
  • Session time-travel with undo, redo, and fork.

Use cases of OpenRouter Agents MCP Server

  • Decompose complex research queries into parallel sub-tasks.
  • Synthesize results from multiple agents with citations.
  • Persist and search research reports and knowledge graphs.
  • Backend for AI assistants requiring multi-step reasoning.
  • Integrate with MCP-compatible clients like Claude, Jan AI, and Continue.

Frequently asked questions

1

What is the default transport?

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

2

Does it require an API key?

Yes, `OPENROUTER_API_KEY` is required. Key rotation and cooldown are supported via optional configuration variables.

3

Does data persist across sessions?

Yes, reports, jobs, and the knowledge graph persist by default. Set `DB_AUTO_HEAL=true` for in-memory mode (no persistence).

4

What models are supported?

Two tiers: high‑cost (e.g., Claude Sonnet 4.5, GPT‑5.2) and low‑cost (e.g., Gemini Flash, DeepSeek). Models are selected via embedding‑based routing.

5

Is it compliant with the MCP specification?

Yes, it complies with MCP Specification 2025‑11‑25 (Stable) and supports core features like Tools, Resources, Prompts, and SEP extensions.

Comments

More Data & Analytics MCP servers

Forency

cheevahagadog

Investigate any website's technology stack: CMS, eCommerce, frameworks, analytics, CRM, payments, and hosting behind any URL. Ask "which of these 15 prospects use HubSpot vs Salesforce?" and get a table back. Free tier:

1

Sugra API MCP

Sugra Systems, Inc.

Official MCP server for the Sugra API, giving AI agents source-attributed access to 1,500+ endpoints across 36 data domains from 160+ primary sources. Covers markets, economics, company fundamentals, government, news, cl

1

AppGoat

App Store and Google Play data for agents: apps, reviews, keyword research, top charts, competitors and ASO audits.

Zillow MCP Server

HasData

HasData's hosted Zillow MCP server lets AI agents search homes for sale, rentals and sold listings, then retrieve property details, price history and Zillow estimates as structured JSON.

4

Agent Margin Router

NovaNest

Remote MCP server with 40 AI agent tools for web search, scraping, research, crypto market data and on-chain analytics. Access 38 data endpoints via Streamable HTTP. Start with 3 free calls per wallet, then pay $0.005–$0

Advertise