Portkey MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.36.4Updated Nov 7, 2026

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

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableCloud & InfrastructureSecurity & MonitoringData & Analytics

Overview

AI-generated overview

Read-only access to Portkey AI-gateway analytics, configs, virtual keys, workspaces, users and audit logs, plus logging request feedback.

What you can do
  • Query cost, request, token, latency, error-rate and cache-hit-rate time series, optionally scoped by virtual keys, configs or metadata
  • Get grouped analytics aggregated by model, user or metadata
  • Inspect gateway configs and their routing, fallback, retry and cache rules
  • List and read API key metadata, virtual keys with provider and limits, workspaces and workspace members
  • List organization users, pending invites and audit log entries
  • Write a quality score with optional weight and metadata against a request trace
When to use it
Useful when you want to ask an assistant about AI-gateway spend, token usage, latency or error trends, or look up which configs, virtual keys, workspaces and users exist in a Portkey organization without opening the dashboard.
Requirements
Remote hosted endpoint connected over streamable HTTP; no local install. Sign-in is via OAuth, and on first connect you paste your Portkey API key, which is validated and stored per user. Do not add an Authorization header or API key to the client config.
Before you install
The Portkey API key is a credential granting access to your organization's gateway data; it is stored by the third-party host. Most tools are read-only, but portkey_create_feedback writes a record into the account. The server also exposes subscription tools that return payment links and can cancel a paid plan, and usage is metered (free tier 50 calls per month, paid plans beyond that).

Installation

In SourceWeft

  1. Open Portkey MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fportkey/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "portkey-by-usefulapi": {
      "type": "http",
      "url": "https://portkey.usefulapi.io/mcp"
    }
  }
}

README

Portkey MCP by usefulapi

Manage Portkey AI-gateway admin and observability from Claude, Cursor, or any MCP client — read analytics, configs, virtual keys, workspaces, users and audit logs, and log request feedback. Hosted, no local install: connect with your Portkey API key.

Live endpoint: https://portkey.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://portkey.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http portkey https://portkey.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "portkey": {      "url": "https://portkey.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Portkey credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/portkey/

On first connect you'll paste your Portkey API key (from the Portkey app → API Keys). It's validated, stored per-user, and scoped to you — no keys in config files.

Tools

ToolTypeWhat it does
portkey_get_analytics_graphreadGet analytics graph
portkey_get_analytics_groupreadGet analytics group
portkey_list_configsreadList configs
portkey_get_configreadGet config
portkey_list_api_keysreadList API keys
portkey_get_api_keyreadGet API key
portkey_list_virtual_keysreadList virtual keys
portkey_get_virtual_keyreadGet virtual key
portkey_list_workspacesreadList workspaces
portkey_get_workspacereadGet workspace
portkey_list_workspace_membersreadList workspace members
portkey_list_usersreadList users
portkey_get_userreadGet user
portkey_list_user_invitesreadList user invites
portkey_list_audit_logsreadList audit logs
portkey_create_feedbackwriteCreate feedback
portkey_usage_statusmetaUsage status (free-tier meter)
portkey_request_featuremetaRequest a missing feature
portkey_upgrademetaUpgrade to Pro or Pro+
portkey_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with portkey_upgrade (it returns a Stripe Checkout link). Cancel any time with portkey_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running portkey_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/portkey/README.md at commit 4046075

Tools

16

portkey_get_analytics_graph

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}.

Parametersmetricrequiredconfigsmetadatatotal_unitsvirtual_keystime_of_generation_maxrequiredtime_of_generation_minrequired

portkey_get_analytics_group

Get analytics group

Get grouped analytics (aggregated by models, users, or metadata) over a time window. Portkey: GET /analytics/groups/{group}.

Parametersgrouprequiredpage_sizecurrent_pagetime_of_generation_maxrequiredtime_of_generation_minrequired

portkey_list_configs

List configs

List gateway configs (routing/fallback/retry/cache rulesets applied to requests). Portkey: GET /configs.

Parametersworkspace_id

portkey_get_config

Get config

Get a single gateway config by slug (or id), including its routing rules. Portkey: GET /configs/{slug}.

Parametersslugrequired

portkey_list_api_keys

List API keys

List API keys in the organization/workspace (metadata only — secrets are never returned). Portkey: GET /api-keys.

Parameterspage_sizecurrent_pageworkspace_id

portkey_get_api_key

Get API key

Get a single API key's metadata by id (the secret is never returned). Portkey: GET /api-keys/{id}.

Parametersidrequired

portkey_list_virtual_keys

List virtual keys

List virtual keys (the aliases that map to provider credentials + budget/rate limits used in requests). Portkey: GET /virtual-keys.

Parameterspage_sizecurrent_page

portkey_get_virtual_key

Get virtual key

Get a single virtual key by slug, including its provider + limits. Portkey: GET /virtual-keys/{slug}.

Parametersslugrequired

portkey_list_workspaces

List workspaces

List workspaces in the organization. Portkey: GET /workspaces.

Parameterspage_sizecurrent_page

portkey_get_workspace

Get workspace

Get a single workspace by slug/id. Portkey: GET /workspaces/{id}.

Parametersidrequired

portkey_list_workspace_members

List workspace members

List members of a workspace (users + their roles). Portkey: GET /workspaces/{id}/members.

Parametersidrequiredpage_sizecurrent_page

portkey_list_users

List users

List users in the organization. Filter by role or email. Portkey: GET /users.

Parametersroleemailpage_sizecurrent_page

portkey_get_user

Get user

Get a single user by id. Portkey: GET /users/{id}.

Parametersidrequired

portkey_list_user_invites

List user invites

List pending user invitations to the organization. Portkey: GET /user-invites.

Parameterspage_sizecurrent_page

portkey_list_audit_logs

List audit logs

List audit log entries (admin actions across the organization). Portkey: GET /audit-logs.

Parameterspage_sizecurrent_page

portkey_create_feedback

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.

Parametersvaluerequiredweightmetadatatrace_idrequired

Version history

21
  1. v1.36.4LatestNov 7, 2026
  2. v1.35.3Nov 5, 2026
  3. v1.35.2Nov 5, 2026
  4. v1.35.1Nov 4, 2026
  5. v1.35.0Nov 3, 2026
  6. v1.34.1Nov 3, 2026
  7. v1.33.0Nov 1, 2026
  8. v1.31.0Oct 31, 2026
  9. v1.30.0Oct 31, 2026
  10. v1.29.2Oct 30, 2026
  11. v1.29.0Oct 30, 2026
  12. v1.24.0Oct 26, 2026
  13. v1.21.3Oct 25, 2026
  14. v1.21.0Oct 25, 2026
  15. v1.20.0Oct 24, 2026
  16. v1.17.0Oct 23, 2026
  17. v1.16.4Oct 22, 2026
  18. v1.16.3Oct 21, 2026
  19. v1.11.1Oct 9, 2026
  20. v1.10.0Oct 9, 2026
  21. v1.0.0Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations

Ably MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for Ably realtime messaging: inspect channel history, presence and occupancy, publish messages, and review app usage and configuration.

Streamable HTTPWeb executable
Cloud & Infrastructure15 toolsNov 7, 2026

Woffu MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant look up Woffu company users, employment contracts, departments and offices.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

White Label Loyalty MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for White Label Loyalty: browse rewards, read a customer's points wallet and tier progress, and buy rewards with points.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

Weekdone MCP by usefulapi

io.usefulapiOfficial publisher

Hosted Weekdone connector that lets an assistant read weekly reports, teams, objectives and KPIs, and add report items, comments and KPI values.

Streamable HTTPWeb executable
Data & Analytics15 toolsNov 7, 2026

WebinarKit MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant list WebinarKit webinars, their dates, series, meetings and white-label sub-accounts.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026