Kyma API

Kyma API MCP 服务

Kyma API 是一个大模型 API 网关，只需一个密钥即可路由至 100 多种模型，并公布各模型经测量的正常运行时间。
所有模型共用一个端点，并提供公开排名和由你设定的支出上限。
https://mcp.kymaapi.com/mcp

安装 · 工具 · 安全与支出 · 示例 · 故障排查 · 注册表

Kyma API 是一个大模型网关：通过一个兼容 OpenAI 的端点（以及一个兼容 Anthropic 的端点），连接开放模型和前沿模型；通过真实流量和定时探测，测量各模型的正常运行时间。此服务为任何 MCP 客户端提供实时目录、价格、排名、正常运行时间和你自己的支出等读取工具，以及一个受每连接支出上限保护的聊天工具。

• 托管式远程服务，支持 OAuth 登录。 使用 Streamable HTTP、OAuth 2.1、PKCE 和动态客户端注册。无需将 API 密钥粘贴到客户端中。
• 每个连接专用一个密钥。 与你的 REST API 密钥分开，默认上限为 每 30 天 10 美元（可在审批页面或 kymaapi.com/integrations 调整为 1 至 500 美元），且随时可以撤销。
• 读取工具不会产生费用。 目录、价格、排名、正常运行时间、额度、支出、你的用量和请求均可免费调用，且大多数客户端会自动批准。
• send_message 会在产生费用前进行定价。 客户端必须先允许调用；系统会根据目录价格计算出符合上限的 max_tokens，并强制执行 max_cost_usd，因此超出上限的调用会在发送任何内容前遭到拒绝。每条回复都会报告本次调用费用、已用支出和上限。
• 测量所得的正常运行时间，而非承诺。 get_model_uptime 会返回 kymaapi.com/status 上各模型过去 30 天的正常运行率。如果请求过程中某条路由失败，Kyma 会通过另一条路由在同一模型上重试。
• 供审核者使用的只读端点。 https://mcp.kymaapi.com/mcp/readonly 接受相同的令牌，但对请求仅保留读取权限：不提供 send_message 或 set_low_balance_alert，无论授权时批准了哪些权限范围。元数据：/.well-known/oauth-protected-resource/mcp/readonly。
• 不止聊天。 同一个 Kyma 密钥还可通过 REST API 用于语音转文本、文本转语音、嵌入、重排序、图像和视频；list_models 会显示所有这些模型。

安装

claude mcp add --transport http kyma https://mcp.kymaapi.com/mcp

{ "mcpServers": { "kyma": { "url": "https://mcp.kymaapi.com/mcp" } } }

{ "servers": { "kyma": { "type": "http", "url": "https://mcp.kymaapi.com/mcp" } } }

# ~/.codex/config.toml
[mcp_servers.kyma]
url = "https://mcp.kymaapi.com/mcp"

codex mcp login kyma

{ "mcpServers": { "kyma": { "url": "https://mcp.kymaapi.com/mcp", "type": "streamableHttp" } } }

gemini extensions install https://github.com/kyma-api/kyma-mcp-plugin

{ "mcpServers": { "kyma": { "command": "npx", "args": ["-y", "@kyma-api/mcp-server"] } } }

共有 18 个工具。默认连接中会显示 16 个；授予审批页面上的可选范围后，会显示 list_keys 和 set_low_balance_alert。

每条 send_message 回复都会包含 cost、spent_usd 和 spend_cap_usd，以及包含提供服务的模型和尝试过的路由的 structuredContent。调用前可通过 get_spend 查看剩余额度。

安全与支出

• **连接可以做什么：**读取模型目录、价格、排名、正常运行时间、你的余额和此连接的支出；在限额内发送聊天补全请求；如果授予可选范围，还可以列出已遮蔽的密钥并设置低余额提醒。
• **连接绝不能做什么：**创建或删除 API 密钥、更改账单或付款方式、购买额度、注册账户或查看服务提供商内部信息。此服务上不存在这些范围。
• **支出限额：**每个连接都有专属密钥及其自身限额，默认每 30 天 10 美元，可在 1 至 500 美元之间调整。限额由服务端强制执行；达到限额后，send_message 会返回错误，直到时间窗口重置，或你在 kymaapi.com/integrations 提高限额。
• **令牌与密钥：**访问令牌有效期为 7 天，刷新令牌有效期为 90 天，并会在使用时轮换；连接密钥以哈希形式（SHA-256）存储，可撤销且不会影响你的 REST API 密钥。
• **提示词注入：**传递给 Agent 的模型输出是不可信文本。请保持客户端对 send_message 的确认提示开启，并且不要让 Agent 将密钥或余额粘贴到其他工具中。
• **数据：**请求日志会保留 90 天，用于账单核对和滥用处理，之后删除。Kyma 不会使用客户数据进行训练。隐私政策：kymaapi.com/privacy。

技能

三项技能用于指导 Agent 更好地使用这些工具：pick-a-model（比较价格、实测正常运行时间和适用性）、check-spend-and-credits（余额、限额、剩余额度、重置日期）、send-a-test-completion（仅在明确允许后发起一次计费调用）。这些技能位于 skills/ 中，可安装到任何支持读取技能的 Agent 中：

npx skills add kyma-api/kyma-mcp-plugin

示例

连接后可粘贴使用的提示词：

• “每百万输出 token 价格低于 $1 的模型中，哪些模型过去 30 天的正常运行时间表现最好？”
• “为 Cline 推荐一个模型和配置，然后显示其价格。”
• “此连接的预算还剩多少，何时重置？”
• “向 qwen-3.6-plus 发送‘用一行总结这段内容’，然后告诉我花费了多少。”
• “显示本周 Kyma 排名中的热门应用。”

故障排除

• 反复要求登录或显示“连接器失败”： 删除连接并重新添加；客户端存储的令牌可能属于已撤销的连接。请在 kymaapi.com/integrations 查看有效连接列表。
• send_message 提示已达到上限： 在 kymaapi.com/integrations 提高上限，或等待 30 天窗口重置；get_spend 会显示日期。
• 工具返回 403 insufficient scope： 批准连接时未授予该可选权限范围。请重新连接，并在批准页面勾选该权限范围。
• Stdio 桥接无法登录： 将 KYMA_MCP_KEY 设置为在 kymaapi.com/integrations 创建的 Kyma MCP 密钥（km-…）；REST kyma-… 密钥会被有意拒绝。
• 远程连接中断： 某些客户端在长时间空闲后需要重新连接；服务本身是无状态的。

注册表和市场

• 官方 MCP Registry：com.kymaapi/kyma（本仓库中的 server.json，通过 mcp-publisher 发布，并由 kymaapi.com 的 DNS 验证命名空间）
• Smithery：kyma-api/kyma
• npm stdio 桥接：@kyma-api/mcp-server
• Gemini CLI 扩展库：gemini-extension.json 和仓库主题 gemini-cli-extension
• 已提交，等待审核：Cursor Marketplace、xAI Grok Build marketplace、Docker MCP Catalog、Cline Marketplace、mcp.so

关于 Kyma API

Kyma 是一个大模型 API 网关：开放模型和前沿模型通过一个端点提供服务，按 token 付费，并在提供商之间自动故障转移；各模型的实测正常运行时间发布于 kymaapi.com/models。新账户可获得免费额度。

• 网站：https://kymaapi.com · 此服务的页面：https://kymaapi.com/mcp · 文档：https://docs.kymaapi.com · 状态：https://kymaapi.com/status
• 支持：[email protected] · 滥用举报：[email protected]
• 更新日志：CHANGELOG.md · 许可证：MIT