{"id":"ca3889b8-fa8b-4d1b-b9c7-ffc505ed8871","slug":"proxyllm-mcp","kind":"mcp","name":"proxyllm-mcp","summary":"MCP server for ProxyLLM, the OpenAI-compatible LLM gateway: model catalog, savings calculator, key introspection, and autonomous email-OTP account signup","owner":"proxyllm-ai","repoUrl":"https://github.com/proxyllm-ai/proxyllm-mcp","license":"MIT","licenseTier":"permissive","trust":"community","stars":0,"logoUrl":"https://avatars.githubusercontent.com/u/292357829?v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["productivity","cloud-infra","utilities"],"tags":[],"runtime":"node","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-14T04:37:12.774Z","sample":false,"url":"https://conduits.dev/tools/proxyllm-mcp","language":"JavaScript","transports":["stdio"],"install":{"npm":"proxyllm-mcp"},"requirements":{"env":[{"name":"PROXYLLM_ACCOUNT_TOKEN","secret":true,"required":false,"description":"Optional sk_/rk_ account token for management tools. Create one autonomously via the proxyllm_signup tool or https://proxyllm.ai/auth.md"},{"name":"PROXYLLM_ROUTING_KEY","secret":true,"required":false,"description":"Optional pllm_ routing key for key introspection and key-scoped model lists."}],"upstreamMayCharge":false},"tools":null,"readme":"# proxyllm-mcp\n\nMCP server for [ProxyLLM](https://proxyllm.ai), the OpenAI-compatible LLM gateway. It gives any MCP client (Claude Code, Claude Desktop, Cursor, Cline, Windsurf, OpenClaw) live model catalogs, plan-savings math, routing-key introspection and provisioning, and an account signup flow an agent can complete on its own: email OTP in, `sk_` account token out, HTTP 402 with a checkout link until a human activates the membership.\n\n## Install\n\nClaude Code:\n\n```bash\nclaude mcp add proxyllm -- npx -y proxyllm-mcp\n```\n\nCursor, Cline, Claude Desktop, or any client that takes a JSON server entry:\n\n```json\n{\n  \"mcpServers\": {\n    \"proxyllm\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"proxyllm-mcp\"]\n    }\n  }\n}\n```\n\nNo configuration is required to start. Two optional environment variables save passing tokens per call:\n\n- `PROXYLLM_ACCOUNT_TOKEN`: an `sk_` (read+write) or `rk_` (read-only) account token for the management tools.\n- `PROXYLLM_ROUTING_KEY`: a `pllm_` routing key for key introspection and key-scoped model lists.\n\n## Tools\n\nFree, no account needed:\n\n- `proxyllm_savings_calculator`: monthly OpenAI API bill in, subscription tier + flat total + monthly savings out.\n- `proxyllm_list_models`: OpenAI-shaped model list from the gateway.\n- `proxyllm_introspect_key`: what a routing key can do (lanes, models, budget, whether a Codex subscription backs it).\n\nAccount flow (an agent can run this end to end):\n\n- `proxyllm_signup`: emails a 6-digit code to the operator's inbox. No captcha.\n- `proxyllm_verify_signup`: exchanges the code for the `sk_` account token (returned once).\n- `proxyllm_account`: account state; while unpaid it carries the checkout link and a message written to be relayed to the operator. Poll until `plan` is `\"pro\"`.\n\nProvisioning (paid accounts):\n\n- `proxyllm_create_routing_key`: mints a `pllm_` key, optionally wiring its provider chain (Codex subscription seats, self-hosted Claude Code bridges, metered API keys) in the same call.\n- `proxyllm_list_routing_keys`: keys, plus the wireable lane ids with `include_lanes`.\n- `proxyllm_usage`: 30-day usage summary.\n\nUnpaid accounts get `402 payment_required` on management tools by design; the body names the price ($129/mo flat), the checkout URL, and the 48-hour removal deadline for never-activated accounts. Error bodies are returned verbatim because they contain the next step.\n\n## Links\n\n- Agent auth manifest: <https://proxyllm.ai/auth.md>\n- OpenAPI: <https://proxyllm.ai/openapi.json>\n- Docs: <https://proxyllm.ai/docs/api>\n- Agent card: <https://proxyllm.ai/.well-known/agent-card.json>\n\nMIT license.\n"}