Portkey MCP server. Read AI-gateway analytics, configs, virtual keys, workspaces and users; log request feedback.
Add to your MCP config, then reload & authorize:
{
"mcpServers": {
"portkey": {
"url": "https://portkey.usefulapi.io/mcp"
}
}
}| Tool | Type | What it does |
|---|---|---|
portkey_get_analytics_graph | read | Get analytics graph Get a time-series analytics graph for a single metric (cost, requests, tokens, latency, error-rate, cache-hit-rate, …) over a time window. Optionally scope by virtual keys, configs, or metadata. Portkey: GET /analytics/graphs/{metric}. |
portkey_get_analytics_group | read | Get analytics group Get grouped analytics (aggregated by models, users, or metadata) over a time window. Portkey: GET /analytics/groups/{group}. |
portkey_list_configs | read | List configs List gateway configs (routing/fallback/retry/cache rulesets applied to requests). Portkey: GET /configs. |
portkey_get_config | read | Get config Get a single gateway config by slug (or id), including its routing rules. Portkey: GET /configs/{slug}. |
portkey_list_api_keys | read | List API keys List API keys in the organization/workspace (metadata only — secrets are never returned). Portkey: GET /api-keys. |
portkey_get_api_key | read | Get API key Get a single API key's metadata by id (the secret is never returned). Portkey: GET /api-keys/{id}. |
portkey_list_virtual_keys | read | List virtual keys List virtual keys (the aliases that map to provider credentials + budget/rate limits used in requests). Portkey: GET /virtual-keys. |
portkey_get_virtual_key | read | Get virtual key Get a single virtual key by slug, including its provider + limits. Portkey: GET /virtual-keys/{slug}. |
portkey_list_workspaces | read | List workspaces List workspaces in the organization. Portkey: GET /workspaces. |
portkey_get_workspace | read | Get workspace Get a single workspace by slug/id. Portkey: GET /workspaces/{id}. |
portkey_list_workspace_members | read | List workspace members List members of a workspace (users + their roles). Portkey: GET /workspaces/{id}/members. |
portkey_list_users | read | List users List users in the organization. Filter by role or email. Portkey: GET /users. |
portkey_get_user | read | Get user Get a single user by id. Portkey: GET /users/{id}. |
portkey_list_user_invites | read | List user invites List pending user invitations to the organization. Portkey: GET /user-invites. |
portkey_list_audit_logs | read | List audit logs List audit log entries (admin actions across the organization). Portkey: GET /audit-logs. |
portkey_create_feedback | write | Create feedback WRITES a feedback record into the Portkey account, attached to a request/trace by trace_id. Use for logging a quality score (typically -10..10) with an optional weight (0..1) and metadata. Portkey: POST /feedback. |
portkey_usage_status | Usage status (free-tier meter) Report the caller's current free-tier usage this month: calls used, monthly limit, remaining, and whether the cap is reached. Read-only; does not count against the meter. | |
portkey_upgrade | Upgrade to Pro (unlimited) Subscribe to the Pro plan for UNLIMITED Portkey tool calls (the free tier caps monthly usage). Choose monthly ($9/month) or yearly ($90/year — 2 months free) billing. Returns a Stripe Checkout link to open in your browser; after payment your account upgrades automatically. Read-only; does not count against the meter. |
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 100 tool calls / month |
| Proper user | $9/mo · $90/yr | Unlimited |
This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.