Proxyllm MCP

What proxyllm-mcp does

proxyllm-mcp MCP server exposes ProxyLLM management functions to MCP-compatible clients. ProxyLLM presents an OpenAI-compatible gateway, and the server lets an agent inspect available models, estimate subscription savings, examine routing-key permissions, manage account access, provision routing keys, and review recent usage.

Several operations are available without an account. The savings calculator accepts a monthly OpenAI API bill and returns a subscription tier, flat total, and estimated monthly savings. The model-list tool returns an OpenAI-shaped catalog from the gateway. Routing-key introspection reports the key’s available lanes and models, budget information, and whether a Codex subscription supports it.

How it works

The server communicates with ProxyLLM through MCP tool calls. It can also complete the account onboarding sequence: signup sends a six-digit one-time code to the operator’s email address, and verification exchanges that code for an sk_ account token. The token is returned only once, so it must be retained by the operator or client.

Account status indicates whether membership is active. Before activation, the account response includes a checkout link and a message intended for the operator. Management calls for unpaid accounts return HTTP 402 with the price, checkout URL, and the deadline for removing never-activated accounts. The documented flow is to poll the account state until plan is "pro".

Setup and configuration

Run the server through npx. Claude Code can add it with:

claude mcp add proxyllm -- npx -y proxyllm-mcp

Clients that accept a JSON MCP server entry can use npx as the command and -y proxyllm-mcp as its arguments. No configuration is needed to launch the server.

Two optional variables avoid passing credentials with individual calls:

• PROXYLLM_ACCOUNT_TOKEN accepts an sk_ read/write account token or an rk_ read-only account token.
• PROXYLLM_ROUTING_KEY accepts a pllm_ routing key for key introspection and key-scoped model lists.

Tools and capabilities

The available tools cover four areas:

• Discovery and estimation: list gateway models and calculate subscription savings from an OpenAI bill.
• Key inspection: inspect routing-key lanes, models, budget, and Codex subscription backing.
• Account onboarding: request an email OTP, verify it, and retrieve account state.
• Provisioning and reporting: create routing keys, list existing keys, inspect wireable lanes with include_lanes, and retrieve a 30-day usage summary.

proxyllm_create_routing_key can configure a provider chain during key creation. The supported chain sources named by the project are Codex subscription seats, self-hosted Claude Code bridges, and metered API keys.

Limitations and notes

proxyllm-mcp MCP server manages ProxyLLM accounts and routing configuration; the provided tool list does not describe a general prompt-completion tool. Paid management operations require an activated account, while the discovery tools are described as free and account-free.

Signup requires access to the operator’s inbox for the six-digit code. Payment activation still requires the operator to follow the checkout step. Read-only rk_ credentials cannot perform the read/write account operations associated with an sk_ token. Error bodies are returned unchanged because they contain the next action, such as the checkout link.