Skip to main content
Glama

⚡ OpenRouter Zero MCP (openrouter-zero-mcp)

The Fastest, Lightest OpenRouter MCP Server for AI Agents.
(Zero third-party dependencies, <30ms startup, multi-model inference for DeepSeek, Claude, Gemini & Llama).

skills.sh compatible Zero-Dependency Startup License: MIT Smithery Glama GitHub stars

# ⚡ 1-Click Install via skills.sh (Claude Code / Codex / Antigravity):
npx skills add Gabrielrtads/openrouter-zero-mcp

# Or install automatically via Smithery for Claude Desktop:
npx -y @smithery/cli install @Gabrielrtads/openrouter-zero-mcp --client claude

⚡ Why OpenRouter Zero?

Feature

Typical OpenRouter MCPs

openrouter-zero-mcp

Dependencies

100+ npm packages or heavy Python venv

Zero (0) native Node.js only

Startup Latency

1.2s - 3.5s

< 30ms instant boot

Memory Footprint

~120MB+

~15MB

JSON-RPC Spec

Often crashes on notifications

100% Spec-Compliant (Handles notifications correctly)


Related MCP server: Zen MCP Server

💻 Manual Setup

1. Claude Desktop

Add this to your claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "openrouter": {
      "command": "npx",
      "args": ["-y", "openrouter-zero-mcp"],
      "env": {
        "OPENROUTER_API_KEY": "sk-or-v1-your-key-here"
      }
    }
  }
}

2. Cursor IDE

  1. Open Cursor Settings (Ctrl+Shift+J or Cmd+Shift+J).

  2. Navigate to Features > MCP Servers > Add New MCP Server.

  3. Fill in:

    • Name: openrouter

    • Type: command

    • Command: npx -y openrouter-zero-mcp

    • Environment Variables: OPENROUTER_API_KEY=sk-or-v1-your-key-here

3. Antigravity / Windsurf / Claude Code

In your mcp_config.json:

{
  "mcpServers": {
    "openrouter": {
      "command": "npx",
      "args": ["-y", "openrouter-zero-mcp"],
      "env": {
        "OPENROUTER_API_KEY": "sk-or-v1-your-key-here"
      }
    }
  }
}

🛠️ Available MCP Tools

1. openrouter_chat_completion

Executes chat completions on any model in the OpenRouter catalog (DeepSeek V3/R1, Gemini 2.5 Flash, Claude 3.7 Sonnet, Llama 3.3 70B, etc.).

  • Parameters: model, messages, prompt, temperature, max_tokens, reasoning.

2. openrouter_get_credits

Checks real-time credit balance, usage, and key parameters.

3. openrouter_list_models

Searches and lists models from the OpenRouter API with pricing per 1M tokens and context window size.

  • Parameters: search (e.g. 'deepseek', 'gemini', 'free'), limit.

4. openrouter_manage_keys

Provisions, lists, or revokes API keys via the OpenRouter Management API.

  • Parameters: action ('list', 'create', 'delete'), name, limit, hash.


🔒 Security & Privacy

  • All API calls are made directly to https://openrouter.ai/api/v1 with your personal key.

  • Zero analytics, zero telemetry, zero middleman proxy.

  • Secrets are read exclusively from environment variables.


⭐ Impressed with OpenRouter Zero?

If this MCP server saved your tokens or sped up your workflow, please star the repository!
It helps other autonomous agent developers discover the project.

Star on GitHub


Built with pride by Gabriel Toledo (@Gabrielrtads)
Creator of Barber.fi, vibe-design-studio, sta, kage-bunshin, and agent-log.

Licensed under MIT.

Available Tools

4 tools
openrouter_chat_completionC

Execute chat inference on any model available on OpenRouter (e.g. google/gemini-2.5-flash, anthropic/claude-3.7-sonnet, deepseek/deepseek-v4-flash-0731:US, meta-llama/llama-3.3-70b-instruct).

Inputs: model, prompt, messages, reasoning, +2 more.

openrouter_get_creditsB

Retrieve account balance, credits usage, and API key limits from OpenRouter.

Inputs: no named parameters.

openrouter_list_modelsC

List available AI models on OpenRouter with filters for name, slug, context window size, and pricing.

Inputs: limit, search.

openrouter_manage_keysB

Manage OpenRouter API keys (list, create, delete) via the Management API. Requires OPENROUTER_MANAGEMENT_KEY.

Inputs: action (required), hash, name, limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool targets a clearly distinct area: chat inference, account credits, model listing, and API key management. There is no meaningful overlap or ambiguity in intent.

    Naming Consistency4/5

    All tools share the openrouter_ prefix and snake_case format, which is highly consistent. The only minor deviation is openrouter_chat_completion, which is noun-based rather than verb_noun like the other three.

    Tool Count5/5

    Four well-scoped tools cleanly cover the OpenRouter integration surface without redundancy. Each tool earns its place for a focused MCP server.

    Completeness4/5

    Core workflows are covered: inference, model discovery, credits, and key lifecycle. Minor gaps exist around richer generation options (e.g. embeddings, streaming controls, per-model usage), but agents can work around them.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers