{"_id":"@aiorouter/mcp","_rev":"4-a566f1b2c4820d76d12643dd73c5e0d8","name":"@aiorouter/mcp","dist-tags":{"latest":"1.1.1"},"versions":{"1.1.0":{"name":"@aiorouter/mcp","version":"1.1.0","keywords":["mcp","aiorouter","model-context-protocol","ai","privacy","claude-desktop"],"license":"MIT","_id":"@aiorouter/mcp@1.1.0","maintainers":[{"name":"tayachu","email":"tayachu@gmail.com"}],"homepage":"https://aiorouter.ca","bugs":{"url":"https://github.com/aiorouter/aiorouter-mcp/issues"},"bin":{"aiorouter-mcp":"cli.js"},"dist":{"shasum":"0a6f73c6f8e1a4744b4365bd00e5e840e32d39d1","tarball":"https://registry.npmjs.org/@aiorouter/mcp/-/mcp-1.1.0.tgz","fileCount":63,"integrity":"sha512-mHxJoBVqRVkziFRelDGFRP/hJzosGGpjAUcmbFlo4r8odGF2tCHz776gZCpLwUgsk8Eo6SK9sZ4DigYAZ4cIEg==","signatures":[{"sig":"MEUCIQCn8xdj4frhXkDVW2iPq6MqWoj3ZMWfrgdqQcWLRKhLwgIgUcH4wpZfcLB4ZTZm64Ellsue6Lhnq++4PUsLjuOt6C0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":75624},"main":"./index.js","type":"module","types":"./index.d.ts","engines":{"node":">=20"},"gitHead":"b9a1033b47887a18aa6910411707f68c2f978211","_npmUser":{"name":"tayachu","email":"tayachu@gmail.com"},"repository":{"url":"git+https://github.com/aiorouter/aiorouter-mcp.git","type":"git"},"_npmVersion":"11.5.1","description":"AIOrouter MCP Server — 15+ AI models, single API key, privacy protection","directories":{},"_nodeVersion":"24.5.0","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp_1.1.0_1785589051069_0.8585655479792966","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"@aiorouter/mcp","version":"1.1.1","keywords":["mcp","aiorouter","model-context-protocol","ai","privacy","claude-desktop"],"license":"MIT","_id":"@aiorouter/mcp@1.1.1","maintainers":[{"name":"tayachu","email":"tayachu@gmail.com"}],"homepage":"https://aiorouter.ca","bugs":{"url":"https://github.com/aiorouter/aiorouter-mcp/issues"},"bin":{"aiorouter-mcp":"cli.js"},"dist":{"shasum":"d0a48fb11e407a81ab804c0f25e085d9609c79ec","tarball":"https://registry.npmjs.org/@aiorouter/mcp/-/mcp-1.1.1.tgz","fileCount":63,"integrity":"sha512-PxwuNPmJl1JJ9qrqdKe+PXxImCK0d+KM1ECJ5RyBCRlQ8H+jYJeq/+8wjbDfv7IY8DG1s+SvkvAWSr6wCHhHwQ==","signatures":[{"sig":"MEUCIArbqe3ADEz7eJWbjVhGyu+G2mhFszvnKvlrWsaQjFN2AiEAvBFk6pMIQXMrIXs8Ubb1oEj/vmTasCRKGKBL3Fw0YoI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":75717},"main":"./index.js","type":"module","types":"./index.d.ts","engines":{"node":">=20"},"gitHead":"b9a1033b47887a18aa6910411707f68c2f978211","_npmUser":{"name":"tayachu","email":"tayachu@gmail.com"},"repository":{"url":"git+https://github.com/aiorouter/aiorouter-mcp.git","type":"git"},"_npmVersion":"11.5.1","description":"AIOrouter MCP Server — 15+ AI models, single API key, privacy protection","directories":{},"_nodeVersion":"24.5.0","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp_1.1.1_1785591836660_0.03595973688001575","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-08-01T12:57:30.871Z","modified":"2026-08-19T19:02:22.672Z","1.1.0":"2026-08-01T12:57:31.215Z","1.1.1":"2026-08-01T13:43:56.843Z"},"bugs":{"url":"https://github.com/aiorouter/aiorouter-mcp/issues"},"license":"MIT","homepage":"https://aiorouter.ca","keywords":["mcp","aiorouter","model-context-protocol","ai","privacy","claude-desktop"],"repository":{"url":"git+https://github.com/aiorouter/aiorouter-mcp.git","type":"git"},"description":"AIOrouter MCP Server — 15+ AI models, single API key, privacy protection","maintainers":[{"email":"tayachu@gmail.com","name":"tayachu"}],"readme":"# @aiorouter/mcp\n\n> AIOrouter MCP Server — Access 15+ AI models through a single API key with PII Shield protection.\n\n[![npm version](https://img.shields.io/npm/v/@aiorouter/mcp.svg)](https://www.npmjs.com/package/@aiorouter/mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n## Features\n\n- **15+ AI models** — Qwen, DeepSeek, GLM, Kimi, Grok, and more through a single API key\n- **MCP Protocol** — Model Context Protocol (stdio transport) for Claude Desktop, Claude Code, and Codex CLI\n- **PII Shield** — Personal information and technical secrets are protected before routing\n- **Zero billing changes** — Same API key, same quota, same billing pipeline as direct API calls\n- **10 MCP tools** — Chat, model listing, pricing, usage, cost estimation, and more\n\n## Quick Start\n\n```bash\n# Set your API key\nexport AIOROUTER_API_KEY=\"ak-your-api-key-here\"\n\n# Run the MCP server\nnpx @aiorouter/mcp\n```\n\nGet your API key at [dashboard.aiorouter.ca/keys](https://dashboard.aiorouter.ca/keys).\n\n## Installation\n\n```bash\n# Global install\nnpm install -g @aiorouter/mcp\n\n# Or use npx (zero install)\nnpx @aiorouter/mcp\n```\n\n## Claude Desktop Setup\n\n### Scenario A: Anthropic Subscription + MCP Tools\n\nUse your Anthropic subscription for Claude, and access 15+ other models through MCP tools.\n\nEdit `claude_desktop_config.json`:\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"aiorouter\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@aiorouter/mcp\"],\n      \"env\": {\n        \"AIOROUTER_API_KEY\": \"ak-your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n### Scenario B: AIOrouter as Third-Party Inference Gateway\n\nRoute ALL Claude Desktop traffic through AIOrouter for complete privacy protection — even Anthropic never sees your real data.\n\n1. Configure AIOrouter as your Claude Desktop third-party inference provider\n2. Add the MCP server config above\n3. All traffic (Claude + non-Claude) goes through AIOrouter PII Shield\n\n## Claude Code Setup\n\nAdd to `.mcp.json` in your project root:\n\n```json\n{\n  \"mcpServers\": {\n    \"aiorouter\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@aiorouter/mcp\"],\n      \"env\": {\n        \"AIOROUTER_API_KEY\": \"ak-your-api-key-here\"\n      },\n      \"type\": \"stdio\"\n    }\n  }\n}\n```\n\n## Codex CLI Setup\n\n```json\n{\n  \"mcpServers\": {\n    \"aiorouter\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@aiorouter/mcp\"],\n      \"env\": {\n        \"AIOROUTER_API_KEY\": \"ak-your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n## Tools Reference\n\n| # | Tool | Description |\n|:---|:---|:---|\n| 1 | `aiorouter_chat` | Send a chat completion to any AIOrouter model |\n| 2 | `aiorouter_list_models` | List all available models with provider info |\n| 3 | `aiorouter_get_presets` | Show CODE-MAS orchestrator triple preset configuration |\n| 4 | `aiorouter_get_pricing` | Get public retail pricing (USD per 1M tokens) |\n| 5 | `aiorouter_get_usage` | Get usage, billing, and subscription status |\n| 6 | `aiorouter_test_connection` | Test API key validity and show account info |\n| 7 | `aiorouter_export_config` | Generate MCP config JSON for Claude Desktop/Code/Codex |\n| 8 | `aiorouter_compare_models` | Compare 2-5 models side-by-side |\n| 9 | `aiorouter_estimate_cost` | Estimate cost for a prompt (input + output tokens) |\n| 10 | `aiorouter_get_model_info` | Get detailed info for a single model |\n\n### Example: Using `aiorouter_chat`\n\nAsk Claude Desktop:\n> \"Use aiorouter_chat to call deepseek-v4-pro and ask: what is MCP protocol?\"\n\nClaude will:\n1. Call `aiorouter_list_models` to confirm the model is available\n2. Call `aiorouter_chat` with `model=\"deepseek-v4-pro\"` and your message\n3. Return the model's response\n\n## Remote HTTP MCP Server\n\nAIOrouter also provides a Remote HTTP MCP Server at `https://api.aiorouter.ca/mcp`:\n\n- **Transport:** Streamable HTTP (stateless)\n- **Auth:** API Key (`Authorization: Bearer ak-...`) or OAuth 2.1\n- **Same 10 tools** as the local stdio server\n\n```bash\n# Example: list tools via HTTP\ncurl -X POST https://api.aiorouter.ca/mcp \\\n  -H \"Authorization: Bearer ak-your-api-key\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\",\"params\":{}}'\n```\n\n## Pricing & Billing\n\n- **Zero changes** to your existing billing — MCP tools use the same API key quota\n- All `aiorouter_chat` calls go through the same billing pipeline (TokenCounter → CreditEngine → BudgetGuard)\n- Check usage at [dashboard.aiorouter.ca/billing](https://dashboard.aiorouter.ca/billing)\n\n## Security\n\n- **PII Shield:** Personal information and technical secrets are protected before routing to any model\n- **API Key Safety:** Your API key stays in your environment variable — never written to disk\n- **HTTPS Only:** All communication with AIOrouter uses HTTPS\n- **No Package Secrets:** This npm package contains zero API keys or secrets\n\n## CLI Commands\n\n```bash\naiorouter-mcp              # Start stdio MCP server (default)\naiorouter-mcp setup        # Interactive setup guide\naiorouter-mcp status       # Check API key validity\naiorouter-mcp version      # Show version\n```\n\n## License\n\n[MIT](./LICENSE)\n","readmeFilename":"README.md"}