Portkey MCP by usefulapi

io.usefulapi由 usefulapi.io 发布官方发布者v1.36.4更新于 Nov 7, 2026

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

发布方自己的服务:Ably MCP by usefulapi

已验证Streamable HTTP可网页运行云端与基础设施安全与监控数据与分析

概览

AI 生成的概览

只读访问 Portkey AI 网关的分析数据、配置、虚拟密钥、工作区、用户和审计日志,并可写入请求反馈。

可以做什么
  • 查询成本、请求数、Token、延迟、错误率和缓存命中率的时间序列,可按虚拟密钥、配置或元数据筛选
  • 获取按模型、用户或元数据聚合的分组分析
  • 查看网关配置及其路由、回退、重试和缓存规则
  • 列出并读取 API 密钥元数据、虚拟密钥(含提供商与限额)、工作区及工作区成员
  • 列出组织用户、待处理邀请和审计日志条目
  • 针对某条请求链路写入带可选权重和元数据的质量评分
适用场景
适合让助手回答 AI 网关的花费、Token 用量、延迟或错误趋势,或在不打开 Portkey 控制台的情况下查询组织内的配置、虚拟密钥、工作区和用户。
运行要求
远程托管端点,通过 streamable HTTP 连接,无需本地安装。使用 OAuth 登录,首次连接时需粘贴 Portkey API 密钥,该密钥会被校验并按用户存储。不要在客户端配置中添加 Authorization 头或 API 密钥。
安装前请注意
Portkey API 密钥是可访问组织网关数据的凭据,会由第三方托管方存储。多数工具为只读,但 portkey_create_feedback 会向账户写入记录。服务器还提供订阅相关工具,会返回付款链接并可取消付费计划;调用次数受限(免费版每月 50 次,付费计划另计)。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Portkey MCP by usefulapi,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.usefulapi%2Fportkey/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "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.

来源:servers/portkey/README.md,提交 4046075

工具

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

输入参数metric必填configsmetadatatotal_unitsvirtual_keystime_of_generation_max必填time_of_generation_min必填

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

输入参数group必填page_sizecurrent_pagetime_of_generation_max必填time_of_generation_min必填

portkey_list_configs

List configs

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

输入参数workspace_id

portkey_get_config

Get config

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

输入参数slug必填

portkey_list_api_keys

List API keys

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

输入参数page_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}.

输入参数id必填

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.

输入参数page_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}.

输入参数slug必填

portkey_list_workspaces

List workspaces

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

输入参数page_sizecurrent_page

portkey_get_workspace

Get workspace

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

输入参数id必填

portkey_list_workspace_members

List workspace members

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

输入参数id必填page_sizecurrent_page

portkey_list_users

List users

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

输入参数roleemailpage_sizecurrent_page

portkey_get_user

Get user

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

输入参数id必填

portkey_list_user_invites

List user invites

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

输入参数page_sizecurrent_page

portkey_list_audit_logs

List audit logs

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

输入参数page_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.

输入参数value必填weightmetadatatrace_id必填

版本历史

21
  1. v1.36.4最新Nov 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

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Usefulapi 集成