{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_uqt3xgenf28c","handle":"openrouter-mcp-2","url":"https://wellknown.network/agents/openrouter-mcp-2","links":{"self":"https://wellknown.network/agents/openrouter-mcp-2/record.json","html":"https://wellknown.network/agents/openrouter-mcp-2","markdown":"https://wellknown.network/agents/openrouter-mcp-2/record.md","api":"https://wellknown.network/api/v1/agents/openrouter-mcp-2","status":"https://wellknown.network/api/v1/agents/openrouter-mcp-2/status","claim":"https://wellknown.network/agents/openrouter-mcp-2/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/openrouter-mcp-2/claim.json","badge":"https://wellknown.network/agents/openrouter-mcp-2/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/openrouter-mcp-2/history","tools":"https://wellknown.network/api/v1/agents/openrouter-mcp-2/tools"},"ard":{"identifier":"urn:air::server:openrouter-mcp-2","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"openrouter-mcp","summary":"MCP server for OpenRouter model discovery","description":"# OpenRouter MCP Server\n\nMCP (Model Context Protocol) server for discovering and querying 300+ AI models available on OpenRouter.\n\n## Features\n\n- **List models** — Browse all available models with pricing, context limits, and capabilities\n- **Search & filter** — Find models by provider, price, context length, features (tools, vision, etc.)\n- **Compare models** — Side-by-side comparison of multiple models\n- **Get details** — Full metadata for any specific model\n- **Cached responses** — 5-minute cache to reduce API calls\n\n## Installation\n\n```bash\npip install openrouter-mcp\n```\n\n## Usage\n\n### With OpenClaw\n\nAdd to your `openclaw.json`:\n\n```json\n{\n  \"mcp\": {\n    \"servers\": {\n      \"openrouter-models\": {\n        \"command\": \"openrouter-mcp\",\n        \"env\": {\n          \"OPENROUTER_API_KEY\": \"your-api-key\"\n        }\n      }\n    }\n  }\n}\n```\n\n> `OPENROUTER_API_KEY` is optional but recommended for higher rate limits.\n\n### Standalone (stdio)\n\n```bash\nexport OPENROUTER_API_KEY=your-key\npython -m openrouter_mcp.server\n```\n\n### Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `list_models` | List all models with optional modality filter and sorting |\n| `get_model` | Get detailed info for a specific model by ID |\n| `search_models` | Search and filter models by query, provider, price, context, features |\n| `compare_models` | Compare multiple models side by side |\n| `refresh_cache` | Force refresh the model cache from OpenRouter API |\n\n## Examples\n\n### List models sorted by context length\n\n```json\n{\n  \"name\": \"list_models\",\n  \"arguments\": {\n    \"modality\": \"text\",\n    \"sort_by\": \"context_length\"\n  }\n}\n```\n\n### Search for Claude models under $5/1M tokens\n\n```json\n{\n  \"name\": \"search_models\",\n  \"arguments\": {\n    \"query\": \"claude\",\n    \"provider\": \"anthropic\",\n    \"max_input_price\": 5.0,\n    \"requires_tools\": true\n  }\n}\n```\n\n### Compare 3 models\n\n```json\n{\n  \"name\": \"compare_models\",\n  \"arguments\": {\n    \"model_ids\": \"anthropic/claude-sonnet-4.6,qwen/qwen3.6-plus,opena…","publisher":null,"homepage":null,"repository":null,"version":"1.0.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:openrouter-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"ai.model-access","name":"Model Access","confidence":1,"provenance":"derived"}],"categories":["ai"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"openrouter-mcp","registry":"pypi","observedAt":"2026-11-03T20:29:49.182Z","publishedAt":"2026-04-21T02:33:22.550654Z","latestVersion":"1.0.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"openrouter-mcp","url":"https://pypi.org/project/openrouter-mcp/","firstSeenAt":"2026-09-10T08:26:54.669Z","fetchedAt":"2026-11-03T20:29:13.364Z","normalizedAt":"2026-11-03T20:29:13.364Z"}]},"firstSeenAt":"2026-09-10T08:26:54.669Z","updatedAt":"2026-11-03T20:29:49.182Z"}