Kyma API

Kyma API MCP サーバー

Kyma API は、1 つのキーで 100 以上のモデルにリクエストをルーティングし、モデルごとに実測稼働率を公開する LLM API ゲートウェイです。
すべてのモデルを 1 つのエンドポイントから利用でき、公開ランキングと自分で設定する利用額上限も備えています。
https://mcp.kymaapi.com/mcp

インストール · ツール · セキュリティと利用額 · 例 · トラブルシューティング · レジストリ

Kyma API は LLM ゲートウェイです。オープンモデルや最先端モデルの前段に、OpenAI 互換のエンドポイント（および Anthropic 互換のエンドポイント）を備えています。実際のトラフィックと定期的なプローブから、モデルごとの稼働率を測定しています。このサーバーを使うと、あらゆる MCP クライアントから、最新のカタログ、価格、ランキング、稼働率、自分の利用額を読み取り専用ツールとして利用でき、接続ごとの利用額上限によって保護されたチャットツールも利用できます。

• ホスト型のリモートサーバーで、OAuth サインインに対応しています。 OAuth 2.1、PKCE、動的クライアント登録を使った Streamable HTTP に対応しています。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 の範囲で調整できます。上限はサーバー側で適用されます。上限に達すると、期間がリセットされるか、kymaapi.com/integrations で上限を引き上げるまで、send_message はエラーを返します。
• トークンとキー： アクセストークンの有効期間は 7 日間、リフレッシュトークンは 90 日間で、使用時にローテーションされます。接続キーはハッシュ化（SHA-256）して保存され、REST API キーに影響を与えずに失効できます。
• プロンプトインジェクション： エージェントに渡されるモデル出力は信頼できないテキストです。send_message に対するクライアントの確認プロンプトを有効にし、エージェントがキーや残高を他のツールに貼り付けないようにしてください。
• データ： リクエストログは、請求の照合と不正利用への対応のため 90 日間保存した後、削除されます。Kyma は顧客データをトレーニングに使用しません。プライバシーについては、kymaapi.com/privacy をご覧ください。

スキル

エージェントがツールをうまく使えるようにする 3 つのスキルがあります。pick-a-model（価格、実測稼働率、適合性を比較）、check-spend-and-credits（残高、上限、残額、リセット日を確認）、send-a-test-completion（明示的な Allow の後に限り、課金対象の呼び出しを 1 回実行）。これらは skills/ にあり、スキルを読み込むエージェントならどれにでもインストールできます：

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

例

接続後に貼り付けて使えるプロンプト：

• 「出力トークン100万個あたり1ドル未満で、過去30日間の稼働率が最も高いモデルはどれですか？」
• 「Cline向けのモデルと設定を提案して、料金も表示してください。」
• 「この接続の予算はあといくら残っていて、いつリセットされますか？」
• 「qwen-3.6-plus に『これを1行で要約してください』と送信して、料金を教えてください。」
• 「今週の Kyma ランキング上位のアプリを表示してください。」

トラブルシューティング

• サインインが繰り返される、または「コネクターに失敗しました」と表示される場合： 接続を削除して、もう一度追加してください。クライアントに保存されたトークンが、取り消された接続のものである可能性があります。有効な接続一覧は kymaapi.com/integrations で確認してください。
• send_message で上限に達したと表示される場合： kymaapi.com/integrations で上限を引き上げるか、30日間の期間がリセットされるまでお待ちください。リセット日は get_spend で確認できます。
• ツールから 403 insufficient scope が返される場合： オプションのスコープを許可せずに接続を承認した可能性があります。再接続し、承認画面で該当する項目にチェックを入れてください。
• Stdio ブリッジでサインインできない場合： kymaapi.com/integrations で作成した Kyma MCP キー（km-…）を KYMA_MCP_KEY に設定してください。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 は LLM API ゲートウェイです。オープンモデルや最先端モデルを単一のエンドポイントから利用でき、トークン単位で課金されます。また、プロバイダー間の自動フェイルオーバーに対応し、モデルごとに測定した稼働率を 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