Log inSubmit server
Portkey Admin MCP logo

Portkey Admin MCP

Manage Portkey users, workspaces, configs, prompts, keys, analytics, and governance through MCP tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Portkey Admin MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "portkey-admin-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "portkey-admin-mcp"
      ],
      "env": {
        "PORTKEY_API_KEY": "YOUR_VALUE_HERE",
        "PORTKEY_TOOL_DOMAINS": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

portkey-admin-mcp exposes the Portkey Admin API to MCP clients, covering administration, configurations, prompts, API keys, analytics, governance, and related control-plane resources. It provides 194 tools, including operations for users, invitations, workspaces, SCIM mappings, configs, and config version history. Run it as a Node.js stdio server with a Portkey API key, then connect it from supported MCP clients such as Claude Code, Cursor, Windsurf, or VS Code. Reach for it when an agent needs to inspect or change Portkey organization resources rather than make ordinary model requests.

Use cases

  • Invite organization users and assign workspace access
  • Audit SCIM group mappings and workspace membership
  • Create and version Portkey routing configs
  • Review per-user request and cost analytics
  • Limit exposed tools to selected Portkey domains

Key features

  • Portkey Admin API access over MCP
  • User, invitation, and workspace administration
  • SCIM group mapping management
  • Config creation, updates, deletion, and version history
  • Per-user usage and cost analytics
  • Domain-based tool filtering

Tools184

What Portkey Admin MCP lets your agent do. Expand a tool for its parameters.

Verified live~79.8k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

24/24 checks healthy over the last 90d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 6d ago via OSV.dev · portkey-admin-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars6Stargazers on the source repository.
npm downloads2.9kPackage downloads in the last 30 days.
Last commit3d agoMost recent push to the default branch.
Tools exposed184Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Portkey Admin MCP works

What portkey-admin-mcp does

portkey-admin-mcp exposes the Portkey Admin API through the Model Context Protocol. Its catalog contains 194 tools spanning prompts, prompt partials and labels, configs, deployments, API keys, secret references, virtual keys, collections, providers, integrations, MCP integrations and servers, guardrails, access policies, egress allowlists, usage limits, analytics, and organization administration.

The administration tools cover the full lifecycle of organization users and workspace access. Agents can list, inspect, invite, update, and remove users; manage pending invitations; assign workspace roles; and remove workspace membership without deleting the organization user. Enterprise-only user and SCIM operations return a 403 response on non-Enterprise Portkey plans.

Config tools support discovery, creation, updates, deletion, and version inspection. Configurations can define routing, caching, retries, and targets. Updating a config creates a new version, while deleting one permanently removes its versions and can break references to its slug.

How it works

The package runs as an MCP server over stdio and calls the Portkey-compatible Admin API using a Portkey API key. Install-time execution with npx -y portkey-admin-mcp avoids requiring a global package installation. The repository also describes an experimental HTTP server option, alongside a build-from-source path that runs the generated Node.js entry point.

Tool discovery is paginated. The complete catalog is approximately 400 KB when a client follows every page, so PORTKEY_TOOL_DOMAINS can restrict the exposed domains, such as prompts,analytics, and reduce context usage. Domain filtering is useful when a client only needs a small operational surface.

This targets the Portkey-compatible API authenticated with x-portkey-api-key. It is not a direct Prisma AIRS or Strata Cloud Manager adapter, and changing an API base URL alone does not provide that interoperability.

Setup and configuration

Create a Portkey API key with the scopes required by the operations the agent will perform. The quick-start configuration passes the key through PORTKEY_API_KEY and starts the package with npx:

bash
PORTKEY_API_KEY=your_key npx -y portkey-admin-mcp

For Claude Code, the same setup can be registered with claude mcp add. Cursor, Windsurf, and VS Code use their respective MCP configuration files with command: "npx", the package name as an argument, and the API key in the server environment.

To run a locally built copy, clone the repository, install dependencies, build it, and configure Node.js to execute build/index.js. The project targets Node.js 24 or newer.

Tools and capabilities

Representative tools include:

  • Discovering users, invitations, workspaces, workspace members, configs, and config versions.
  • Inviting users, resending or deleting pending invitations, and changing user details or organization roles.
  • Creating workspaces and configs, updating their settings, and permanently deleting them.
  • Managing direct workspace membership and SCIM group-to-workspace mappings.
  • Reviewing per-user request and cost analytics for a specified time range.
  • Restricting the exposed tool catalog by domain for narrower client contexts.

Use discovery tools before mutation tools when an operation requires an ID or slug. For example, list_all_users finds a user ID, list_workspaces finds a workspace ID, and list_configs finds a config slug.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Portkey Admin MCP

portkey-admin-mcp is an MCP server that connects AI clients to the Portkey Admin API through a Portkey API key. Its tools manage users, invitations, workspaces, SCIM mappings, configs, prompts, API keys, analytics, governance, and other Portkey control-plane resources.

Run it with `PORTKEY_API_KEY=your_key npx -y portkey-admin-mcp`. You can also register the same command in an MCP client configuration or clone the repository, build it, and run its generated Node.js entry point.

portkey-admin-mcp works with Claude Code, Cursor, Windsurf, and VS Code through standard stdio MCP configuration. The setup examples use `npx` as the command and pass `PORTKEY_API_KEY` in the server environment.

Set `PORTKEY_TOOL_DOMAINS` to a comma-separated list of domains, such as `prompts,analytics`, before starting the server. Domain filtering narrows the catalog exposed to the client and reduces the context needed for tool discovery.

Yes, but Enterprise-gated operations return HTTP 403 on non-Enterprise plans. The affected areas include several user administration, user analytics, and SCIM group or workspace-mapping tools.

Related MCP servers

All in Conversational AI All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewPortkey Admin MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/portkey-admin-mcp?style=directory)](https://allmcps.com/mcp/portkey-admin-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/portkey-admin-mcp"><img src="https://allmcps.com/api/badge/portkey-admin-mcp?style=directory" alt="Portkey Admin MCP on AllMCPs" /></a>