Portkey MCP Server

Full Portkey Admin API MCP server — configs, prompts, keys, analytics, and more.

Remote serverstreamable-http

What is the Portkey MCP server?

Connect Portkey to Claude, Cursor or any other MCP client and it stops being a tab you switch to. Full Portkey Admin API MCP server — configs, prompts, keys, analytics, and more. The portkey mcp server is what makes that connection.

What the server does

You need a Portkey API key with appropriate scopes. Get one from your Portkey dashboard under API Keys.

Installation

Because this one is hosted, setup is mostly authentication — you point your client at the endpoint and approve access. Nothing runs on your machine, so there is no runtime to keep patched.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • Area — Tools
  • Audit — list_audit_logs
  • Configuration — Production containers must choose their rate-limit topology explicitly: set RATE_LIMIT_STORE=redis for multi-instance deployments, or set

Credentials and setup notes

Configuration is passed through the environment: PORTKEY_API_KEY, PORTKEY_BASE_URL, MCP_PUBLIC_BASE_URL, MCP_AUTH_TOKEN, PORTKEY_ALLOW_PRIVATE_BASE_URL, MCP_REDIS_URL, MCP_EVENT_ENCRYPTION_KEY, MCP_TLS_KEY_PATH. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Worth knowing first

  • Your data travels to the provider's service, so the usual questions apply about what you send and what they retain.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Where it fits

Plenty of database access servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Portkey's toolset — Area, Audit, Configuration — is a fair guide to whether it matches your workflow. It is maintained by CodesWhat; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Available tools

ToolWhat it does
AreaTools
Auditlist_audit_logs
ConfigurationProduction containers must choose their rate-limit topology explicitly: set RATE_LIMIT_STORE=redis for multi-instance deployments, or set RATE_LIMIT_SINGLE_PROCESS=true only for a single long-lived process.

How to install the Portkey MCP server

Then use this config:
```json
{
  "mcpServers": {
    "portkey-admin": {
      "command": "node",
      "args": ["/path/to/portkey-admin-mcp/build/index.js"],
      "env": {
        "PORTKEY_API_KEY": "your_api_key"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
PORTKEY_API_KEYCredential the server authenticates with.Yes
PORTKEY_BASE_URLCredential the server authenticates with.Yes
MCP_PUBLIC_BASE_URLEndpoint or connection string the server talks to.Yes
MCP_AUTH_TOKENCredential the server authenticates with.Yes
PORTKEY_ALLOW_PRIVATE_BASE_URLCredential the server authenticates with.Yes
MCP_REDIS_URLEndpoint or connection string the server talks to.Yes
MCP_EVENT_ENCRYPTION_KEYCredential the server authenticates with.Yes
MCP_TLS_KEY_PATHCredential the server authenticates with.Yes

Example prompts to try

  • Use Portkey to Area.
  • Use Portkey to Audit.
  • Use Portkey to Configuration.

Frequently asked questions

It connects Portkey to MCP-compatible AI assistants such as Claude and Cursor, exposing 3 tools (Area, Audit, Configuration) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Portkey directly.