{
  "markdown": "# 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",
  "bytes": 2613,
  "sha": "c496017860cee6024d0b2bf314f141cd08d3b3a4536767126612e52ecec3e9a9",
  "repo_slug": "proxyllm-ai/proxyllm-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_proxyllm_proxyllm_mcp_c5388335/readme"
}