Overview
What is Portkey MCP Server?
Portkey MCP Server connects Claude to Portkey's API, enabling comprehensive management of AI configurations, workspaces, analytics, and user access. It is for administrators and developers who want to control their Portkey platform directly from an AI assistant.
How to use Portkey MCP Server?
Install the server from source (npm install, copy .env.example, add PORTKEY_API_KEY) or automatically via Smithery (npx -y @smithery/cli install @r-huijts/portkey-admin-mcp-server --client claude). Then configure Claude Desktop’s claude_desktop_config.json with the server command (node /path/to/build/index.js) and environment variable. Restart Claude to apply.
Key features of Portkey MCP Server
- User & access management: list, invite, and assign roles.
- Analytics & reporting: track usage, costs, and request metrics.
- Workspace management: view, configure, and manage virtual keys.
- Configuration & API settings: access caching, retries, and routing.
- Filtered reports based on custom criteria like status codes.
Use cases of Portkey MCP Server
- “What are my current API usage statistics across different models?”
- “Show me the performance metrics for my AI deployments.”
- “Create a new workspace for my team’s project.”
- “Generate an analytics report for last month’s API calls.”
- “Configure fallback behavior for my production endpoints.”
FAQ from Portkey MCP Server
What does the Portkey MCP Server do?
It transforms your AI assistant into a Portkey platform expert by connecting Claude to Portkey’s API, allowing management of configurations, workspaces, analytics, and user access.
How do I install the Portkey MCP Server?
You can install it from source by cloning the repository, running npm install, copying .env.example to .env, and adding your Portkey API key. Alternatively, install via Smithery using the provided CLI command.
What configuration is required?
You must provide your Portkey API key via the PORTKEY_API_KEY environment variable, either in a .env file or directly in the Claude Desktop configuration’s env section.
How do I configure it with Claude Desktop?
Edit the claude_desktop_config.json file to add a mcpServers entry with the server command (node /path/to/build/index.js) and the environment variable PORTKEY_API_KEY, then restart Claude Desktop.
What can I manage with the Portkey MCP Server?
You can manage users and invitations, view analytics and cost data, oversee workspaces and virtual keys, and inspect configurations like cache settings and retry policies.
