Portkey Admin MCP Server

Name: portkey-admin-mcp
Author: s-b-e-n-s-o-n

MCP server for Portkey Admin API. 116 tools for prompts, configs, analytics & more.

📑 Contents

🚀 Quick Start

Add to Claude config (~/.claude/claude_desktop_config.json):

{ "mcpServers": { "portkey": { "command": "npx", "args": ["-y", "portkey-admin-mcp"], "env": { "PORTKEY_API_KEY": "your_api_key" } } } }

Restart Claude Desktop. That's it!

git clone https://github.com/s-b-e-n-s-o-n/portkey-admin-mcp.git cd portkey-admin-mcp npm install npm run build

Then use this config:

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

✨ Features

🔧 Tools (116)

Tool	Description
`list_all_users`	List all users in organization
`get_user`	Get user details
`update_user`	Update user
`delete_user`	Remove user
`invite_user`	Invite a new user
`list_user_invites`	List pending invites
`get_user_invite`	Get invite details
`delete_user_invite`	Cancel invite
`resend_user_invite`	Resend invite email
`get_user_stats`	Get user statistics

Tool	Description
`list_workspaces`	List all workspaces
`get_workspace`	Get workspace details
`create_workspace`	Create workspace
`update_workspace`	Update workspace
`delete_workspace`	Delete workspace
`add_workspace_member`	Add member to workspace
`list_workspace_members`	List workspace members
`get_workspace_member`	Get member details
`update_workspace_member`	Update member role
`remove_workspace_member`	Remove member

Tool	Description
`list_configs`	List gateway configs
`get_config`	Get config details
`create_config`	Create config
`update_config`	Update config
`delete_config`	Delete config
`list_config_versions`	List config version history

Tool	Description
`list_api_keys`	List API keys
`create_api_key`	Create API key
`get_api_key`	Get API key details
`update_api_key`	Update API key
`delete_api_key`	Delete API key
`list_virtual_keys`	List virtual keys
`create_virtual_key`	Create virtual key
`get_virtual_key`	Get virtual key details
`update_virtual_key`	Update virtual key
`delete_virtual_key`	Delete virtual key

Tool	Description
`list_collections`	List prompt collections
`create_collection`	Create a collection
`get_collection`	Get collection details
`update_collection`	Update collection
`delete_collection`	Delete collection

Tool	Description
`list_prompts`	List prompts
`create_prompt`	Create a prompt template
`get_prompt`	Get prompt details
`update_prompt`	Update a prompt
`delete_prompt`	Delete prompt
`publish_prompt`	Publish prompt version
`list_prompt_versions`	List version history
`render_prompt`	Render prompt with variables
`run_prompt_completion`	Execute prompt completion
`migrate_prompt`	Create-or-update prompt
`promote_prompt`	Promote prompt between environments
`validate_completion_metadata`	Validate billing metadata

Tool	Description
`create_prompt_partial`	Create reusable partial
`list_prompt_partials`	List partials
`get_prompt_partial`	Get partial details
`update_prompt_partial`	Update partial
`delete_prompt_partial`	Delete partial
`list_partial_versions`	List partial versions
`publish_partial`	Publish partial version

Tool	Description
`create_prompt_label`	Create label
`list_prompt_labels`	List labels
`get_prompt_label`	Get label details
`update_prompt_label`	Update label
`delete_prompt_label`	Delete label

Tool	Description
`list_guardrails`	List guardrails
`create_guardrail`	Create guardrail
`get_guardrail`	Get guardrail details
`update_guardrail`	Update guardrail
`delete_guardrail`	Delete guardrail

Tool	Description
`list_usage_limits`	List usage limits
`create_usage_limit`	Create usage limit
`get_usage_limit`	Get limit details
`update_usage_limit`	Update limit
`delete_usage_limit`	Delete limit

Tool	Description
`list_rate_limits`	List rate limits
`create_rate_limit`	Create rate limit
`get_rate_limit`	Get rate limit details
`update_rate_limit`	Update rate limit
`delete_rate_limit`	Delete rate limit

Tool	Description
`list_audit_logs`	List audit log entries

Tool	Description
`get_cost_analytics`	Get cost analytics data
`get_analytics_summary`	Get analytics summary
`get_analytics_by_models`	Analytics by model
`get_analytics_by_metadata`	Analytics by metadata
`get_request_analytics`	Request analytics
`get_token_analytics`	Token usage analytics
`get_latency_analytics`	Latency analytics
`get_error_analytics`	Error analytics
`get_error_rate_analytics`	Error rate analytics
`get_status_code_analytics`	Status code distribution
`get_cache_analytics`	Cache analytics
`get_feedback_analytics`	Feedback analytics
`get_user_analytics`	Per-user analytics
`get_cache_hit_latency`	Cache hit latency
`get_cache_hit_rate`	Cache hit rate
`get_feedback_per_model`	Feedback per model
`get_feedback_score_distribution`	Score distribution
`get_requests_per_user`	Requests per user
`get_rescued_requests`	Rescued requests
`get_weighted_feedback`	Weighted feedback

Tool	Description
`insert_log`	Insert log entry
`create_log_export`	Create log export
`list_log_exports`	List exports
`get_log_export`	Get export details
`update_log_export`	Update export
`start_log_export`	Start export job
`cancel_log_export`	Cancel export
`download_log_export`	Download export

Tool	Description
`create_feedback`	Create feedback
`update_feedback`	Update feedback
`list_traces`	List traces
`get_trace`	Get trace details

Tool	Description
`list_providers`	List providers
`create_provider`	Create provider
`get_provider`	Get provider details
`update_provider`	Update provider
`delete_provider`	Delete provider

Tool	Description
`list_integrations`	List integrations
`create_integration`	Create integration
`get_integration`	Get integration details
`update_integration`	Update integration
`delete_integration`	Delete integration
`list_integration_models`	List custom models
`update_integration_models`	Update custom models
`delete_integration_model`	Delete custom model
`list_integration_workspaces`	List workspace access
`update_integration_workspaces`	Update workspace access

🏗️ Architecture

sequenceDiagram participant Client as Client (Claude) participant Transport as MCP Transport<br/>(Stdio or HTTP) participant Server as MCP Server participant Facade as PortkeyService participant Domain as Domain Service<br/>(e.g., UsersService) participant API as Portkey API Client->>Transport: Tool invocation request Transport->>Server: Forward request Server->>Server: Parse tool name & params Server->>Facade: Call delegated method Facade->>Domain: Delegate to domain service Domain->>API: HTTP GET /users API-->>Domain: JSON response Domain-->>Facade: Return typed data Facade-->>Server: Return data Server-->>Transport: Tool result Transport-->>Client: Display result

🚢 Deployment

Transports

Transport	Use Case	Default
`stdio`	Local CLI tools (Claude Code, Cursor)	Yes
`Streamable HTTP`	Remote clients, web, production	-

Set via MCP_TRANSPORT=stdio|http environment variable.

HTTP Mode

MCP_TRANSPORT=http MCP_PORT=3000 node build/index.js

Exposes a single /mcp endpoint with session management via Mcp-Session-Id header.

Docker

docker build -t portkey-admin-mcp . docker run -e PORTKEY_API_KEY=your_key -p 3000:3000 portkey-admin-mcp

Health Endpoints

GET /health - Server status
GET /ready - Portkey API connectivity check

⚠️ Limitations

Enterprise Features

The following require a Portkey Enterprise plan with Admin API keys:

Analytics (cost, request, token, latency, error, cache, feedback)
Log exports
Audit logs
User management (list users, invites)
Provider creation

Known Issues

Some endpoints are pending Portkey API clarification:

Tool	Status	Issue
`render_prompt`	500	Server error - investigating
`create_prompt_label`	400	Request format unclear
`create_usage_limit`	400	Request format unclear
`create_rate_limit`	400	Request format unclear
`list_traces`	405	Endpoint path unclear

Built With

TypeScript Node.js Zod

MIT License · Inspired by r-huijts/portkey-admin-mcp-server

↑ Back to top

portkey-admin-mcp