# proxyllm-mcp

Connect an agent to ProxyLLM model listings, subscription cost estimates, and account and routing-key tools.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: proxyllm-ai
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/proxyllm-ai/proxyllm-mcp
- Updated: 2026-07-15
- HTML: https://affpapa.org/en/nevibecode/mcp/proxyllm-mcp

## What it does

The server fetches ProxyLLM’s model catalog in an OpenAI-style format and estimates how a subscription compares with current OpenAI API spending. It can also inspect a routing key’s model access, budget, and Codex subscription backing. These lookup and calculation tools work without an account.

An agent can request an email verification code, exchange it for an account token, and check account status. Once a paid plan is active, it can create routing keys and attach provider chains. Account management uses `PROXYLLM_ACCOUNT_TOKEN`; key inspection uses `PROXYLLM_ROUTING_KEY`. Management calls on unpaid accounts return `402 payment_required`, so the paid-plan gate applies before key provisioning or other account operations.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `PROXYLLM_ACCOUNT_TOKEN`, `PROXYLLM_ROUTING_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add proxyllm-mcp -e PROXYLLM_ACCOUNT_TOKEN=<PROXYLLM_ACCOUNT_TOKEN> -e PROXYLLM_ROUTING_KEY=<PROXYLLM_ROUTING_KEY> -- npx -y proxyllm-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add proxyllm-mcp --env PROXYLLM_ACCOUNT_TOKEN=<PROXYLLM_ACCOUNT_TOKEN> --env PROXYLLM_ROUTING_KEY=<PROXYLLM_ROUTING_KEY> -- npx -y proxyllm-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "proxyllm-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "proxyllm-mcp"
            ],
            "env": {
                "PROXYLLM_ACCOUNT_TOKEN": "<PROXYLLM_ACCOUNT_TOKEN>",
                "PROXYLLM_ROUTING_KEY": "<PROXYLLM_ROUTING_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "proxyllm-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "proxyllm-mcp"
            ],
            "env": {
                "PROXYLLM_ACCOUNT_TOKEN": "<PROXYLLM_ACCOUNT_TOKEN>",
                "PROXYLLM_ROUTING_KEY": "<PROXYLLM_ROUTING_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e PROXYLLM_ACCOUNT_TOKEN=<PROXYLLM_ACCOUNT_TOKEN> -e PROXYLLM_ROUTING_KEY=<PROXYLLM_ROUTING_KEY> proxyllm-mcp npx -y proxyllm-mcp
```
Replace <…> with your own values

## When to use it
- estimate subscription costs against an OpenAI API bill
- inspect models and budget access for a routing key
- obtain an account token through email verification
- create a routing key with a provider chain
- review account usage over 30 days

## Example prompts
- Estimate how a subscription compares with my monthly OpenAI API bill.
- List the models available to this routing key and inspect its budget.
- Start signup, verify the email code, and check the account status.

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16730
- [labelhead-artist-momentum](https://affpapa.org/en/nevibecode/mcp/labelhead-artist-momentum.md) — MCP server · ★ 107701
- [Agent Skills Search Server](https://affpapa.org/en/nevibecode/mcp/agent-skills-search-server.md) — MCP server · ★ 26673
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23283
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9369
- [PraisonAI](https://affpapa.org/en/nevibecode/mcp/praisonai.md) — MCP server · ★ 9298

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md