Skip to main content
Glama
@aiorouter/mcp
by AIOCANA

@aiorouter/mcp

AIOrouter MCP Server — Access 15+ AI models through a single API key with PII Shield protection.

npm version License: MIT

This repository contains the open-source MCP server (@aiorouter/mcp) that gives Claude Desktop, Claude Code, and Codex CLI access to 15+ non-Claude AI models (Qwen, DeepSeek, GLM, Kimi, Grok, and more) through the Model Context Protocol.

⚠️ This is the public, sanitized package repo only. The AIOrouter gateway backend (routing, billing, PII Shield pipeline, internal infrastructure) is proprietary and is NOT part of this repository.

Features

  • 15+ AI models — Qwen, DeepSeek, GLM, Kimi, Grok, and more through a single API key

  • MCP Protocol — Model Context Protocol (stdio transport) for Claude Desktop, Claude Code, and Codex CLI

  • PII Shield — Personal information and technical secrets are protected before routing

  • 10 MCP tools — Chat, model listing, pricing, usage, cost estimation, and more

  • Zero billing changes — Same API key, same quota, same billing pipeline as direct API calls

Related MCP server: Model Hub MCP

Quick Start

⚠️ AIOrouter is a PAID service — no free tier. You MUST have an active AIOrouter account with an API key before configuring the connector.

export AIOROUTER_API_KEY="ak-your-api-key-here"
npx @aiorouter/mcp

STEP 0 — Prerequisites (MUST complete BEFORE install)

Do not install/configure the connector until you have a real API key.

  1. Register an account: https://dashboard.aiorouter.ca/keys

  2. Subscribe & pay — AIOrouter is a paid service, no free tier (API keys are only issued after account activation + payment)

  3. Generate an API key (format: ak-...) from the dashboard

  4. Have your real key ready before continuing

STEP 1 — Install (only after you have an API key)

Installation below.

STEP 2 — Verify (before using)

AIOROUTER_API_KEY="ak-your-real-key" aiorouter-mcp status
# ✅ Connected! ... models available.  ← correct
# ❌ Connection failed: ...              ← key invalid or account not active

⚠️ FOR AI ASSISTANTS (Claude / Codex / Copilot / etc.):

  1. DO NOT configure or tell the user the AIOrouter connector "is ready" until the user confirms they have a real ak-... API key.

  2. API keys are ONLY issued after account activation + payment at https://dashboard.aiorouter.ca/keys. AIOrouter has NO free tier.

  3. If the user has no key: STOP and guide them to register + pay FIRST.

  4. Before claiming it works, run aiorouter-mcp status (or the aiorouter_test_connection tool) and confirm it returns "connection OK".

  5. Do not fabricate, reuse, or hardcode an API key. Each user must have their own key from their own account.

Installation

npm install -g @aiorouter/mcp
# or
npx @aiorouter/mcp

Client Setup

Claude Desktop

Edit claude_desktop_config.json:

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

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

{
  "mcpServers": {
    "aiorouter": {
      "command": "npx",
      "args": ["-y", "@aiorouter/mcp"],
      "env": { "AIOROUTER_API_KEY": "ak-your-api-key-here" }
    }
  }
}

Claude Code

Add to .mcp.json in your project root:

{
  "mcpServers": {
    "aiorouter": {
      "command": "npx",
      "args": ["-y", "@aiorouter/mcp"],
      "env": { "AIOROUTER_API_KEY": "ak-your-api-key-here" },
      "type": "stdio"
    }
  }
}

Codex CLI

Install (Codex v0.146+ plugin marketplace — MCP server bundled):

# 1. Add this repository as a Codex plugin marketplace (once):
codex plugin marketplace add AIOCANA/aiorouter-mcp

# 2. Install the plugin — the MCP server is declared via mcpServers in plugin.json,
#    so tools appear automatically (no separate codex mcp add needed):
codex plugin add aiorouter

# 3. Set your API key when prompted (or export in your shell):
export AIOROUTER_API_KEY=ak-your-api-key-here

# 4. Verify:
codex mcp list    # → aiorouter with 10 tools

Manual alternative — ~/.codex/config.toml:

[mcp_servers.aiorouter]
command = "npx"
args = ["-y", "@aiorouter/mcp"]
env = { AIOROUTER_API_KEY = "ak-your-api-key-here" }

See codex/plugins/aiorouter/README.md for details.

Tools (10)

#

Tool

Description

1

aiorouter_chat

Send a chat completion to any AIOrouter model

2

aiorouter_list_models

List all available models with provider info

3

aiorouter_get_presets

Show CODE-MAS orchestrator triple preset configuration

4

aiorouter_get_pricing

Get public retail pricing (USD per 1M tokens)

5

aiorouter_get_usage

Get usage and billing balance

6

aiorouter_test_connection

Test API key validity and show account info

7

aiorouter_export_config

Generate MCP config JSON for Claude Desktop/Code/Codex

8

aiorouter_compare_models

Compare 2-5 models side-by-side

9

aiorouter_estimate_cost

Estimate cost for a prompt (input + output tokens)

10

aiorouter_get_model_info

Get detailed info for a single model

Remote HTTP MCP Server

AIOrouter also provides a Remote HTTP MCP Server at https://api.aiorouter.ca/mcp:

  • Transport: Streamable HTTP (stateless)

  • Auth: API Key (Authorization: Bearer ak-...) or OAuth 2.1

  • Same 10 tools as the local stdio server

curl -X POST https://api.aiorouter.ca/mcp \
  -H "Authorization: Bearer ak-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Development

# Install deps
npm install

# Build (tsc → dist/)
npm run build

# Protocol smoke test (needs a real API key for full test)
$env:AIOROUTER_API_KEY="ak-..."   # PowerShell
node scripts/mcp-smoke-test.mjs

# Prepare publish dir
npm run publish:prepare

See docs/mcp-connector-guide.md for the Claude Connector Directory submission guide.

Security

  • PII Shield: Personal information and technical secrets are protected before routing to any model

  • API Key Safety: Your API key stays in your environment variable — never written to disk

  • HTTPS Only: All communication with AIOrouter uses HTTPS

  • No Package Secrets: This npm package contains zero API keys or secrets

Report vulnerabilities via SECURITY.md.

License

MIT

Available Tools

10 tools
aiorouter_chatAIOrouter ChatA

Send a chat completion to any AIOrouter model (Qwen, DeepSeek, GLM, Kimi, Grok, etc). Returns the model's full response. Non-streaming only (MCP limitation). Increase max_tokens (up to 8192) for long responses.

Inputs: model (required), messages (required), max_tokens, temperature.

aiorouter_compare_modelsCompare AIOrouter ModelsA
Read-only

Compare 2-5 AIOrouter models side-by-side: provider, pricing, context window, max output, and capabilities.

Inputs: models (required).

aiorouter_estimate_costEstimate AIOrouter CostA
Read-only

Estimate the cost (USD) for a prompt given model, input tokens, and output tokens. Uses public retail pricing.

Inputs: model (required), input_tokens (required), output_tokens.

aiorouter_export_configExport AIOrouter ConfigA
Read-only

Generate MCP configuration JSON for Claude Desktop, Claude Code, or Codex CLI.

Inputs: target (required).

aiorouter_get_model_infoGet AIOrouter Model InfoA
Read-only

Get detailed info for a single AIOrouter model: provider, context window, max output, capabilities, pricing, and supported parameters.

Inputs: model (required).

aiorouter_get_presetsGet AIOrouter PresetsA
Read-only

Show the triple preset configuration (planner/coder/reviewer) for CODE-MAS orchestrator.

Inputs: no named parameters.

aiorouter_get_pricingGet AIOrouter PricingA
Read-only

Get public retail pricing for AIOrouter models (USD per 1M tokens).

Inputs: model.

aiorouter_get_usageGet AIOrouter Usage & BillingA
Read-only

Get current usage, billing summary, and subscription status for your API key.

Inputs: no named parameters.

aiorouter_list_modelsList AIOrouter ModelsA
Read-only

List all available AI models through AIOrouter. Filter by provider name.

Inputs: provider.

aiorouter_test_connectionTest AIOrouter ConnectionA
Read-only

Test whether your AIOrouter API key is valid.

Inputs: no named parameters.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 10 tools

    Disambiguation5/5

    Each tool targets a distinct resource or action: chat, model listing, model details, comparison, pricing, cost estimation, usage, connection test, config export, and presets. While list_models and get_model_info both relate to models, the former enumerates models while the latter provides detailed info for a single model, making the distinction clear. The descriptions reinforce these boundaries.

    Naming Consistency5/5

    All tools follow a consistent aiorouter_ prefix with a verb_noun pattern: chat, list_models, get_usage, get_pricing, export_config, compare_models, etc. Naming is uniform, snake_case, and verbs align with the operation. No mixed conventions or vague verbs like 'do_thing'.

    Tool Count5/5

    With 10 tools, the server is well-scoped for an AI router service. Each tool earns its place by covering distinct user needs: interaction, exploration, cost management, and configuration. This is within the ideal 3-15 range and neither feels sparse nor overwhelming.

    Completeness5/5

    The surface covers the core domain comprehensively: chat completions, model discovery (list, get, compare), pricing and cost estimation, account usage, connection validation, and configuration export. No obvious dead ends or missing essential operations for the stated purpose of interacting with AIOrouter. The only noted limitation (non-streaming) is a technical constraint, not a tool gap.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that enables AI applications to access 20+ model providers (including OpenAI, Anthropic, Google) through a unified interface for text and image generation.
      2
      30
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      An MCP server that retrieves and provides AI model information from OpenAI, Anthropic, and Google through a unified interface.
      3
      60 npm
      MIT
    • A
      license
      A
      quality
      F
      maintenance
      MCP server that provides AI assistants with real-time, current information about AI models from OpenAI, Anthropic, and Google, including pricing, capabilities, and context windows.
      4
      53 PyPI
      MIT