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.
ProxyLLM MCP has 9 tools with clear action verbs and reasonable descriptions (avg 180 chars). All tools have input schemas with type definitions and parameter descriptions. However, output schemas are not documented, responses are returned as raw JSON without field-level documentation. Error handling is minimal; most tools return API responses verbatim without recovery guidance. Parameter descriptions lack constraint details (ranges, formats, enums). No tool annotations (readOnlyHint/destructiveHint) despite clear risk classifications in metadata.
GET /v1/organizations/me. Works while unpaid: plan is "free" plus a payment block until the operator activates the membership, then "pro". Poll this after handing over the checkout link.
Mints a pllm_ routing key (returned once) for OPENAI_API_KEY-style use against the gateway. Optionally wires the provider chain in the same call; discover wireable lane ids with proxyllm_list_routing_keys include_lanes.
GET /v1/key: the key's provider lanes, reachable models, whether a Codex subscription backs it, and monthly budget state. Authed by the routing key itself.
OpenAI-shaped model list from the gateway. No auth required; with a routing key it reflects that key's lanes, including the live Codex catalog.
Lists the account's routing keys. include_lanes adds the wireable lanes (connected Codex sessions, bridges, saved provider keys) with the ids provider chains reference.
Output schemas not documented. Tools return raw API responses without field-level documentation, forcing LLMs to infer structure and increasing parsing errors.
Error handling returns API responses verbatim without recovery guidance. Errors like 'No account token' lack actionable next steps for the LLM.
Tool annotations missing. Tools marked as WRITE (signup, verify, create_routing_key) lack destructiveHint; READ_ONLY tools lack readOnlyHint. Agents cannot infer safety properties.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 64 | 2026-07-28+ | v2 |
Given a monthly OpenAI API bill in USD, returns the ChatGPT/Codex subscription tier that absorbs that workload through ProxyLLM Codex Hosted, the flat total (subscription + $129 fee), and the monthly savings. Free, no auth.
Starts autonomous account creation: a 6-digit code is emailed to the operator's inbox (no captcha, no browser). New accounts are unpaid and are removed after 48 hours unless a human activates the membership. Follow with proxyllm_verify_signup.
GET /v1/organizations/usage for the account.
Exchanges the 6-digit code for an sk_ account token. The token is returned exactly once: store it (PROXYLLM_ACCOUNT_TOKEN). While the account is unpaid the response carries a checkout link to relay to the operator.
Parameter constraints not documented in descriptions. 'monthly_budget_usd' has minimum but no description of valid range; 'code' has no format hint (6-digit); 'mode' enum not explained.
Account token handling relies on environment variable fallback (ENV_TOKEN) without clear documentation. Parameter descriptions do not explain when to pass token vs relying on env var.