ai.proxyllm/proxyllm-mcp
OpenAI-compatible LLM gateway: models, savings math, key provisioning, autonomous email-OTP signup
What can you do with ai.proxyllm/proxyllm-mcp?
proxyllm_savings_calculator: monthly OpenAI API bill in, subscription tier + flat total + monthly savings out.proxyllm_list_models: OpenAI-shaped model list from the gateway.proxyllm_introspect_key: what a routing key can do (lanes, models, budget, whether a Codex subscription backs it).proxyllm_signup: emails a 6-digit code to the operator's inbox. No captcha.proxyllm_verify_signup: exchanges the code for thesk_account token (returned once).proxyllm_account: account state; while unpaid it carries the checkout link and a message written to be relayed to the operator. Poll untilplanis"pro".proxyllm_create_routing_key: mints apllm_key, optionally wiring its provider chain (Codex subscription seats, self-hosted Claude Code bridges, metered API keys) in the same call.proxyllm_list_routing_keys: keys, plus the wireable lane ids withinclude_lanes.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
proxyllm-mcpclaude mcp add proxyllm-mcp -e 'PROXYLLM_ACCOUNT_TOKEN=<your proxyllm_account_token>' -e 'PROXYLLM_ROUTING_KEY=<your proxyllm_routing_key>' -- npx -y proxyllm-mcp@1.0.2
{
"mcpServers": {
"proxyllm-mcp": {
"command": "npx",
"args": [
"-y",
"proxyllm-mcp@1.0.2"
],
"env": {
"PROXYLLM_ACCOUNT_TOKEN": "<your proxyllm_account_token>",
"PROXYLLM_ROUTING_KEY": "<your proxyllm_routing_key>"
}
}
}
}
Environment variables
PROXYLLM_ACCOUNT_TOKENsecret Optional sk_/rk_ account token for management tools. Create one autonomously via the proxyllm_signup tool or https://proxyllm.ai/auth.mdPROXYLLM_ROUTING_KEYsecret Optional pllm_ routing key for key introspection and key-scoped model lists.
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
proxyllm-mcp
MCP server for ProxyLLM, 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.
Install
Claude Code:
claude mcp add proxyllm -- npx -y proxyllm-mcp
Cursor, Cline, Claude Desktop, or any client that takes a JSON server entry:
{
"mcpServers": {
"proxyllm": {
"command": "npx",
"args": ["-y", "proxyllm-mcp"]
}
}
}
No configuration is required to start. Two optional environment variables save passing tokens per call:
PROXYLLM_ACCOUNT_TOKEN: ansk_(read+write) orrk_(read-only) account token for the management tools.PROXYLLM_ROUTING_KEY: apllm_routing key for key introspection and key-scoped model lists.
Tools
Free, no account needed:
proxyllm_savings_calculator: monthly OpenAI API bill in, subscription tier + flat total + monthly savings out.proxyllm_list_models: OpenAI-shaped model list from the gateway.proxyllm_introspect_key: what a routing key can do (lanes, models, budget, whether a Codex subscription backs it).
Account flow (an agent can run this end to end):
proxyllm_signup: emails a 6-digit code to the operator's inbox. No captcha.proxyllm_verify_signup: exchanges the code for thesk_account token (returned once).proxyllm_account: account state; while unpaid it carries the checkout link and a message written to be relayed to the operator. Poll untilplanis"pro".
Provisioning (paid accounts):
proxyllm_create_routing_key: mints apllm_key, optionally wiring its provider chain (Codex subscription seats, self-hosted Claude Code bridges, metered API keys) in the same call.proxyllm_list_routing_keys: keys, plus the wireable lane ids withinclude_lanes.proxyllm_usage: 30-day usage summary.
Unpaid 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.
Links
- Agent auth manifest: https://proxyllm.ai/auth.md
- OpenAPI: https://proxyllm.ai/openapi.json
- Docs: https://proxyllm.ai/docs/api
- Agent card: https://proxyllm.ai/.well-known/agent-card.json
MIT license.
Frequently asked questions
What is ai.proxyllm/proxyllm-mcp?
OpenAI-compatible LLM gateway: models, savings math, key provisioning, autonomous email-OTP signup
How do I install ai.proxyllm/proxyllm-mcp?
It runs on your machine. In Claude Code: claude mcp add proxyllm-mcp -e 'PROXYLLM_ACCOUNT_TOKEN=<your proxyllm_account_token>' -e 'PROXYLLM_ROUTING_KEY=<your proxyllm_routing_key>' -- npx -y proxyllm-mcp@1.0.2. For other clients, paste the JSON configuration from this page into their MCP settings.
Does ai.proxyllm/proxyllm-mcp need an API key?
Yes. It expects PROXYLLM_ACCOUNT_TOKEN, PROXYLLM_ROUTING_KEY, which you set in its configuration.
Is ai.proxyllm/proxyllm-mcp open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains ai.proxyllm/proxyllm-mcp?
It is published by proxyllm-ai. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.