# portkey-admin-mcp

Connects coding agents to the Portkey control plane. It helps configure gateway routing, prompt versions, budgets, and keys directly inside the editor.

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

## What it does

This server exposes the Portkey control plane to coding assistants through its Admin API. It provides 194 tools covering prompt versions and gateway routing configs. Running it requires Node.js 24 or newer. You also need a valid `PORTKEY_API_KEY`.

Loading the entire 194-tool catalog takes roughly 400 KB across paginated requests. Without `PORTKEY_TOOL_DOMAINS`, tool definitions consume prompt context immediately. Passing specific domains like `prompts,analytics` cuts payload size down. That keeps your chat responsive.

The implementation expects Portkey authentication via the `x-portkey-api-key` header. Pointing `PORTKEY_BASE_URL` at Prisma AIRS will not work because Prisma uses separate authentication schemes. You can execute the package directly via `npx` or build the TypeScript code from source.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `PORTKEY_API_KEY`, `PORTKEY_TOOL_DOMAINS`, `PORTKEY_BASE_URL` — 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 --env PORTKEY_API_KEY=<PORTKEY_API_KEY> --env PORTKEY_TOOL_DOMAINS=<PORTKEY_TOOL_DOMAINS> --env PORTKEY_BASE_URL=<PORTKEY_BASE_URL> --transport stdio portkey-admin-mcp -- npx -y portkey-admin-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add portkey-admin-mcp --env PORTKEY_API_KEY=<PORTKEY_API_KEY> --env PORTKEY_TOOL_DOMAINS=<PORTKEY_TOOL_DOMAINS> --env PORTKEY_BASE_URL=<PORTKEY_BASE_URL> -- npx -y portkey-admin-mcp
```
Replace <…> with your own values

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e PORTKEY_API_KEY=<PORTKEY_API_KEY> -e PORTKEY_TOOL_DOMAINS=<PORTKEY_TOOL_DOMAINS> -e PORTKEY_BASE_URL=<PORTKEY_BASE_URL> portkey-admin-mcp npx -y portkey-admin-mcp
```
Replace <…> with your own values

## When to use it
- Manage versions and partials for Portkey prompts
- Configure gateway routing, retries, and load balancing
- Set up guardrails and access policies for LLM models
- Monitor spend budgets and token usage limits
- Manage provider virtual keys and external secrets

## Example prompts
- Update the Portkey gateway config to balance traffic between two providers.
- Check current token consumption and budget limits in my Portkey account.
- Create a new prompt version for customer support and tag it with `staging`.

## 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