{"_id":"proxyllm-mcp","_rev":"3-ec18a521f30cf6256ebdae954c935b89","name":"proxyllm-mcp","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"proxyllm-mcp","version":"1.0.0","keywords":["mcp","modelcontextprotocol","llm-gateway","openai-compatible","proxyllm","codex","http-402","agent"],"author":{"url":"https://proxyllm.ai","name":"ProxyLLM"},"license":"MIT","_id":"proxyllm-mcp@1.0.0","maintainers":[{"name":"ericotten","email":"ericotten20@gmail.com"}],"homepage":"https://proxyllm.ai/docs/api","bugs":{"url":"https://github.com/ericslab/proxyllm-mcp/issues"},"bin":{"proxyllm-mcp":"server.js"},"dist":{"shasum":"44ee551f8e3fac8cf26ef57be98673ce3b8fb1fe","tarball":"https://registry.npmjs.org/proxyllm-mcp/-/proxyllm-mcp-1.0.0.tgz","fileCount":4,"integrity":"sha512-X/TG9y8h4fS1MQwbcgMWAM4hfg88d/Tr8oJ5x5I4apBqRg/6r6lZFC4zh6EC/flCEYtmh5cRG4olgmdfUZT2UA==","signatures":[{"sig":"MEUCICrpaJnQsHi9Ryu0txDEWkNfqx/kROJJpGnXoaARbBvBAiEA/c2yV3+pyRZrZNJ2DIk/Z3glfE2dbPOL6TyphvdJcIA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":13907},"type":"module","engines":{"node":">=18"},"gitHead":"bc4ccefc04c8720a4879213b0844ac41a6f84ade","scripts":{"start":"node server.js"},"_npmUser":{"name":"ericotten","email":"ericotten20@gmail.com"},"repository":{"url":"git+https://github.com/ericslab/proxyllm-mcp.git","type":"git"},"_npmVersion":"11.12.1","description":"MCP server for ProxyLLM, the OpenAI-compatible LLM gateway. Model catalog, plan-savings calculator, routing-key introspection and provisioning, and autonomous email-OTP account signup.","directories":{},"_nodeVersion":"26.0.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/proxyllm-mcp_1.0.0_1784059130361_0.47371741057490646","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"proxyllm-mcp","version":"1.0.1","keywords":["mcp","modelcontextprotocol","llm-gateway","openai-compatible","proxyllm","codex","http-402","agent"],"author":{"url":"https://proxyllm.ai","name":"ProxyLLM"},"license":"MIT","_id":"proxyllm-mcp@1.0.1","maintainers":[{"name":"ericotten","email":"ericotten20@gmail.com"}],"homepage":"https://proxyllm.ai/docs/api","bugs":{"url":"https://github.com/ericslab/proxyllm-mcp/issues"},"bin":{"proxyllm-mcp":"server.js"},"dist":{"shasum":"617ddbf101103562021c249d855f58dd98fdaf2b","tarball":"https://registry.npmjs.org/proxyllm-mcp/-/proxyllm-mcp-1.0.1.tgz","fileCount":4,"integrity":"sha512-3jHMa2mWuZ3JRhn24gUL+WIUt2Wo4pJ3ukfVGWrZmyjU/GskshBJPvO/b2LQovZemAvQGl0HLOJ09dyInGxEMQ==","signatures":[{"sig":"MEUCIQCTuXnhaqCGFl14XY/vcIostOeaV5Op+EueqiQ9Rcg4PwIgM5qUvI7kqts44KYjbN5jq6andeilZJ1mesRGrqCpoi4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":13948},"type":"module","engines":{"node":">=18"},"gitHead":"0bc9f99cda690be8e8a834fc8105e386d9131aee","mcpName":"ai.proxyllm/proxyllm-mcp","scripts":{"start":"node server.js"},"_npmUser":{"name":"ericotten","email":"ericotten20@gmail.com"},"repository":{"url":"git+https://github.com/ericslab/proxyllm-mcp.git","type":"git"},"_npmVersion":"11.12.1","description":"MCP server for ProxyLLM, the OpenAI-compatible LLM gateway. Model catalog, plan-savings calculator, routing-key introspection and provisioning, and autonomous email-OTP account signup.","directories":{},"_nodeVersion":"26.0.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/proxyllm-mcp_1.0.1_1784059211645_0.3692362726263081","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"proxyllm-mcp","version":"1.0.2","description":"MCP server for ProxyLLM, the OpenAI-compatible LLM gateway. Model catalog, plan-savings calculator, routing-key introspection and provisioning, and autonomous email-OTP account signup.","type":"module","bin":{"proxyllm-mcp":"server.js"},"engines":{"node":">=18"},"keywords":["mcp","modelcontextprotocol","llm-gateway","openai-compatible","proxyllm","codex","http-402","agent"],"author":{"name":"ProxyLLM","url":"https://proxyllm.ai"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/proxyllm-ai/proxyllm-mcp.git"},"homepage":"https://proxyllm.ai/docs/api","dependencies":{"@modelcontextprotocol/sdk":"^1.12.0","zod":"^3.24.0"},"mcpName":"ai.proxyllm/proxyllm-mcp","scripts":{"start":"node server.js"},"gitHead":"ed09d8e46f91ad413b737424d76927057263cf80","_id":"proxyllm-mcp@1.0.2","bugs":{"url":"https://github.com/proxyllm-ai/proxyllm-mcp/issues"},"_nodeVersion":"26.0.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-s9HleQTcpDgzwCU9Py1ezeW49KXRzU480ZAV7a32Mp1B9MF+M5gWRTDmqFYVA07aQOXHAirBPealFjIa+7IZIw==","shasum":"a4e66450490f16e5b9e90c0989b179bd93928dc7","tarball":"https://registry.npmjs.org/proxyllm-mcp/-/proxyllm-mcp-1.0.2.tgz","fileCount":4,"unpackedSize":13951,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIC8fYLF9HXQ3fPggPgGKGtGxenA+706m/3/kv6s8r13jAiEA1yFxz4I0rWCOZo9Xco5sVuBMIamItMdB+9/Q2tZ0ONM="}]},"_npmUser":{"name":"ericotten","email":"ericotten20@gmail.com"},"directories":{},"maintainers":[{"name":"ericotten","email":"ericotten20@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/proxyllm-mcp_1.0.2_1784090559007_0.12702234591362016"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-14T19:58:50.292Z","modified":"2026-07-15T04:42:39.258Z","1.0.0":"2026-07-14T19:58:50.510Z","1.0.1":"2026-07-14T20:00:11.782Z","1.0.2":"2026-07-15T04:42:39.146Z"},"bugs":{"url":"https://github.com/proxyllm-ai/proxyllm-mcp/issues"},"author":{"name":"ProxyLLM","url":"https://proxyllm.ai"},"license":"MIT","homepage":"https://proxyllm.ai/docs/api","keywords":["mcp","modelcontextprotocol","llm-gateway","openai-compatible","proxyllm","codex","http-402","agent"],"repository":{"type":"git","url":"git+https://github.com/proxyllm-ai/proxyllm-mcp.git"},"description":"MCP server for ProxyLLM, the OpenAI-compatible LLM gateway. Model catalog, plan-savings calculator, routing-key introspection and provisioning, and autonomous email-OTP account signup.","maintainers":[{"name":"ericotten","email":"ericotten20@gmail.com"}],"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: \n- OpenAPI: \n- Docs: \n- Agent card: \n\nMIT license.\n","readmeFilename":"README.md"}