English Français العربية

ai.proxyllm/proxyllm-mcp

السجل الرسمي الإنتاجية

OpenAI-compatible LLM gateway: models, savings math, key provisioning, autonomous email-OTP signup

الشيفرة المصدرية الموقع التوثيق

ماذا يمكنك أن تفعل مع 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 the sk_ 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 until plan is "pro".
  • 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.
  • proxyllm_list_routing_keys: keys, plus the wireable lane ids with include_lanes.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package proxyllm-mcp
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
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "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>"
            }
        }
    }
}

متغيرات البيئة

  • PROXYLLM_ACCOUNT_TOKEN سري Optional sk_/rk_ account token for management tools. Create one autonomously via the proxyllm_signup tool or https://proxyllm.ai/auth.md
  • PROXYLLM_ROUTING_KEY سري Optional pllm_ routing key for key introspection and key-scoped model lists.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. proxyllm-mcp
  2. Install
  3. Tools
  4. Links

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: an sk_ (read+write) or rk_ (read-only) account token for the management tools.
  • PROXYLLM_ROUTING_KEY: a pllm_ 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 the sk_ 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 until plan is "pro".

Provisioning (paid accounts):

  • 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.
  • proxyllm_list_routing_keys: keys, plus the wireable lane ids with include_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.

MIT license.

الأسئلة الشائعة

ما هو ai.proxyllm/proxyllm-mcp؟

OpenAI-compatible LLM gateway: models, savings math, key provisioning, autonomous email-OTP signup

كيف أثبّت ai.proxyllm/proxyllm-mcp؟

يعمل على جهازك. في 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. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج ai.proxyllm/proxyllm-mcp إلى مفتاح API؟

نعم. يتطلب PROXYLLM_ACCOUNT_TOKEN, PROXYLLM_ROUTING_KEY، وتضبطها في إعداداته.

هل ai.proxyllm/proxyllm-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون ai.proxyllm/proxyllm-mcp؟

ينشره proxyllm-ai. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.