usefulapi

Portkey MCP server. Read AI-gateway analytics, configs, virtual keys, workspaces and users; log request feedback.

Claude

  1. Open Settings → Connectors → Add custom connector
  2. Paste this URL:
    https://portkey.usefulapi.io/mcp
  3. Authenticate with Portkey when prompted

Cursor · VS Code · Windsurf · Cline

Add to your MCP config, then reload & authorize:

{
  "mcpServers": {
    "portkey": {
      "url": "https://portkey.usefulapi.io/mcp"
    }
  }
}
live18 toolsFree 100 tool calls / monthPro $9/mo · $90/yr

Tools 18

ToolTypeWhat it does
portkey_get_analytics_graphread
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_groupread
Get analytics group
Get grouped analytics (aggregated by models, users, or metadata) over a time window. Portkey: GET /analytics/groups/{group}.
portkey_list_configsread
List configs
List gateway configs (routing/fallback/retry/cache rulesets applied to requests). Portkey: GET /configs.
portkey_get_configread
Get config
Get a single gateway config by slug (or id), including its routing rules. Portkey: GET /configs/{slug}.
portkey_list_api_keysread
List API keys
List API keys in the organization/workspace (metadata only — secrets are never returned). Portkey: GET /api-keys.
portkey_get_api_keyread
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_keysread
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_keyread
Get virtual key
Get a single virtual key by slug, including its provider + limits. Portkey: GET /virtual-keys/{slug}.
portkey_list_workspacesread
List workspaces
List workspaces in the organization. Portkey: GET /workspaces.
portkey_get_workspaceread
Get workspace
Get a single workspace by slug/id. Portkey: GET /workspaces/{id}.
portkey_list_workspace_membersread
List workspace members
List members of a workspace (users + their roles). Portkey: GET /workspaces/{id}/members.
portkey_list_usersread
List users
List users in the organization. Filter by role or email. Portkey: GET /users.
portkey_get_userread
Get user
Get a single user by id. Portkey: GET /users/{id}.
portkey_list_user_invitesread
List user invites
List pending user invitations to the organization. Portkey: GET /user-invites.
portkey_list_audit_logsread
List audit logs
List audit log entries (admin actions across the organization). Portkey: GET /audit-logs.
portkey_create_feedbackwrite
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_statusmeta
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_upgrademeta
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.

Pricing

PlanPriceLimit
Free$0100 tool calls / month
Proper user$9/mo · $90/yrUnlimited

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.