[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_117":118},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":-5,"_57":49,"_58":59,"_60":61,"_62":63,"_64":65,"_66":67,"_68":47,"_69":70,"_71":72,"_73":74,"_75":76,"_77":78,"_79":-5,"_80":-5,"_81":-5,"_82":49,"_83":-5,"_84":59,"_85":86,"_87":88,"_89":90,"_91":92,"_93":94},"apiUrl","https://odel.app/api","creator","kyma-api","moduleId","kyma-mcp-plugin","@kyma-api/kyma-mcp-plugin","displayName","Kyma API","tagline","Live model catalog with prices and measured uptime, rankings, credits and spend, spend-capped chat.","iconKey","https://raw.githubusercontent.com/kyma-api/kyma-mcp-plugin/main/assets/logo-400.png","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://mcp.kymaapi.com/mcp\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1788495812000,"updatedAt",1788668586000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=com.kymaapi%2Fkyma","sourceVerified",false,"sourceMissingSince","importedAt","upstreamStars",0,"upstreamUpdatedAt",1788653369000,"detectedTransport","streamable-http","detectedAuthType","oauth","probeStatus","ok","lastProbedAt","githubRepoUrl","https://github.com/kyma-api/kyma-mcp-plugin","githubRepoFullName","kyma-api/kyma-mcp-plugin","releaseId","ext-kyma-api-kyma-mcp-plugin","version","1.0.3","descriptionMarkdown","

\n $\"Kyma$ \n

\n\n

Kyma API MCP Server

\n\n

\n Kyma API is an LLM API gateway that routes one key to 120+ models and publishes measured uptime per model.
\n Every model behind one endpoint, with public rankings and a spend cap you set.
\n https://mcp.kymaapi.com/mcp\n

\n\n

\n $\"MCP$ \n $\"npm\"$ \n $\"Docs\"$ \n $\"License\"$ \n

\n\n

\n Install · Tools · Security and spend · Examples · Troubleshooting · Registries\n

\n\nKyma API is an LLM gateway: one OpenAI-compatible endpoint (plus an Anthropic-compatible one) in front of open and frontier models, with uptime measured per model from real traffic and scheduled probes. This server gives any MCP client the live catalog, prices, rankings, uptime and your own spend as read tools, and one chat tool that is guarded by a per-connection spend cap.\n\n- **Hosted, remote, OAuth sign-in.** Streamable HTTP with OAuth 2.1, PKCE and dynamic client registration. No API key is pasted into the client.\n- **A dedicated key per connection.** Separate from your REST API keys, capped at **$10 per 30 days** by default (adjustable from $1 to $500 on the approval screen or at [kymaapi.com/integrations](https://kymaapi.com/integrations)), revocable at any time.\n- **Read tools never charge.** Catalog, pricing, rankings, uptime, credits, spend, your usage and your requests are free to call and auto-approved by most clients.\n- **`send_message` is priced before it spends.** The client must allow it first; `max_cost_usd` is enforced by deriving a `max_tokens` that fits the ceiling from the catalog price, so a call above it is refused before anything is sent. Every reply reports what the call cost, what has been spent and the cap.\n- **Measured uptime, not a promise.** `get_model_uptime` returns the 30-day rate per model from [kymaapi.com/status](https://kymaapi.com/status). If a route fails mid-request, Kyma retries the same model on another route.\n- **A read-only endpoint for reviewers.** `https://mcp.kymaapi.com/mcp/readonly` accepts the same tokens but keeps only read scopes for the request: no `send_message`, no `set_low_balance_alert`, whatever the grant was approved with. Metadata: `/.well-known/oauth-protected-resource/mcp/readonly`.\n- **Beyond chat.** The same Kyma key covers speech-to-text, text-to-speech, embeddings, rerank, image and video through the REST API; `list_models` shows all of them.\n\n## Install\n\n

Claude Code

\n\n```bash\nclaude mcp add --transport http kyma https://mcp.kymaapi.com/mcp\n```\n\nRun `/mcp` to sign in. This repository is also a Claude Code plugin (`.claude-plugin/plugin.json` + `.mcp.json`).\n

\n\n

Claude.ai and Claude Desktop

\n\nSettings → Connectors → **Add custom connector** → paste `https://mcp.kymaapi.com/mcp` → sign in with Kyma.\n

\n\n

Cursor

\n\nOne click: [**Add to Cursor**](https://cursor.com/en/install-mcp?name=Kyma&config=eyJ1cmwiOiJodHRwczovL21jcC5reW1hYXBpLmNvbS9tY3AifQ==)\n\nOr in `.cursor/mcp.json`:\n\n```json\n{ \"mcpServers\": { \"kyma\": { \"url\": \"https://mcp.kymaapi.com/mcp\" } } }\n```\n

\n\n

VS Code (GitHub Copilot)

\n\nOne click: [**Install in VS Code**](https://vscode.dev/redirect/mcp/install?name=kyma&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.kymaapi.com%2Fmcp%22%7D)\n\nOr in `.vscode/mcp.json`:\n\n```json\n{ \"servers\": { \"kyma\": { \"type\": \"http\", \"url\": \"https://mcp.kymaapi.com/mcp\" } } }\n```\n

\n\n

Codex CLI

\n\n```toml\n# ~/.codex/config.toml\n[mcp_servers.kyma]\nurl = \"https://mcp.kymaapi.com/mcp\"\n```\n\n```bash\ncodex mcp login kyma\n```\n

\n\n

Cline

\n\nCline → MCP Servers → **Configure MCP Servers**:\n\n```json\n{ \"mcpServers\": { \"kyma\": { \"url\": \"https://mcp.kymaapi.com/mcp\", \"type\": \"streamableHttp\" } } }\n```\n\nCline CLI: `cline mcp add kyma https://mcp.kymaapi.com/mcp --transport streamableHttp --yes`. Cline asks you to sign in with Kyma on first use.\n

\n\n

Gemini CLI

\n\n```bash\ngemini extensions install https://github.com/kyma-api/kyma-mcp-plugin\n```\n\nThe first tool call opens a browser for OAuth sign-in, handled by Gemini CLI.\n

\n\n

Grok

\n\n- **grok.com**: Connectors → New Connector → Custom → paste the URL.\n- **Grok Build**: this repository is a Claude Code format plugin; Grok Build loads it as-is.\n

\n\n

ChatGPT (Developer Mode)

\n\nSettings → Connectors (Plus, Pro, Business, Enterprise, Edu) → add the URL → sign in. ChatGPT connections never see `get_topup_link`.\n

\n\n

Any stdio-only client

\n\n```json\n{ \"mcpServers\": { \"kyma\": { \"command\": \"npx\", \"args\": [\"-y\", \"@kyma-api/mcp-server\"] } } }\n```\n\nThe bridge runs `mcp-remote` against the hosted URL, so the tools are exactly the hosted ones. Set `KYMA_MCP_KEY=km-…` (a Kyma MCP key from [kymaapi.com/integrations](https://kymaapi.com/integrations), not a REST `kyma-…` key) to skip the browser. Source: [`bridge/`](https://github.com/kyma-api/kyma-mcp-plugin/blob/main/bridge/).\n

\n\n## Tools\n\n18 tools. 16 appear on a default connection; `list_keys` and `set_low_balance_alert` appear when their optional scopes are granted on the approval screen.\n\n| Tool | What it does | Scope | Approval |\n|---|---|---|---|\n| `list_models` | Live model catalog with prices, context window and capabilities | `models.read` | auto, read-only |\n| `get_model` | One model's details | `models.read` | auto, read-only |\n| `list_pricing` | Prices across the catalog | `models.read` | auto, read-only |\n| `list_rankings` | Top models and apps from real traffic | `models.read` | auto, read-only |\n| `get_model_uptime` | Measured 30-day uptime per model | `models.read` | auto, read-only |\n| `recommend_model` | Best model and config for Cline, Cursor, Claude Code and other agents | `models.read` | auto, read-only |\n| `search_docs` | Search Kyma docs | `models.read` | auto, read-only |\n| `ping` | Health check | `models.read` | auto, read-only |\n| `get_credits` | Your balance | `usage.read` | auto, read-only |\n| `get_spend` | This connection's cap, spent, remaining and reset date | `usage.read` | auto, read-only |\n| `get_usage` | Your requests, tokens and cost by model over a window | `usage.read` | auto, read-only |\n| `get_request` | One request by id: model served, tokens, cost, routes tried | `usage.read` | auto, read-only |\n| `estimate_cost` | What a call would cost before you make it | `models.read` | auto, read-only |\n| `get_transactions` | Recent credit ledger entries | `usage.read` | auto, read-only |\n| `get_topup_link` | Balance and the billing page (a link, never a checkout) | `usage.read` | auto, read-only |\n| `list_keys` | Your REST API keys by name, masked | `keys.read` (optional) | auto, read-only |\n| `set_low_balance_alert` | Balance at which Kyma emails you | `billing.alerts` (optional) | asks once |\n| `send_message` | A chat completion through any model; the only tool that spends credit; optional `max_tokens` and `max_cost_usd` | `chat.completions` | asks once; no charge without your Allow |\n\nEvery `send_message` reply carries `cost`, `spent_usd` and `spend_cap_usd`, plus `structuredContent` with the model that served it and the routes tried. `get_spend` shows what is left before you call it.\n\n## Security and spend\n\n- **What a connection can do:** read the catalog, prices, rankings, uptime, your balance and this connection's spend; send chat completions up to its cap; with optional scopes, list your keys masked and set a low-balance alert.\n- **What it can never do:** create or delete API keys, change billing or payment methods, buy credits, register accounts, or see provider internals. Those scopes do not exist on this server.\n- **Spend cap:** each connection gets a dedicated key with its own cap, $10 per 30 days by default, adjustable from $1 to $500. The cap is enforced on the server; when it is reached `send_message` returns an error until the window resets or you raise the cap at [kymaapi.com/integrations](https://kymaapi.com/integrations).\n- **Tokens and keys:** access tokens live 7 days, refresh tokens 90 days and rotate on use; connection keys are stored hashed (SHA-256) and can be revoked without touching your REST API keys.\n- **Prompt injection:** model output that reaches your agent is untrusted text. Keep your client's confirmation prompt on for `send_message`, and do not let the agent paste keys or balances into other tools.\n- **Data:** request logs are kept 90 days for billing reconciliation and abuse handling, then deleted. Kyma does not train on customer data. Privacy: [kymaapi.com/privacy](https://kymaapi.com/privacy).\n\n## Skills\n\nThree skills teach an agent how to use the tools well: `pick-a-model` (compare price, measured uptime and fit), `check-spend-and-credits` (balance, cap, remaining, reset date), `send-a-test-completion` (one billed call, only after an explicit Allow). They live in [`skills/`](https://github.com/kyma-api/kyma-mcp-plugin/blob/main/skills/) and install into any agent that reads skills:\n\n```bash\nnpx skills add kyma-api/kyma-mcp-plugin\n```\n\n## Examples\n\nPrompts you can paste once connected:\n\n- \"Which models under $1 per million output tokens have the best 30-day uptime?\"\n- \"Recommend a model and config for Cline, then show its price.\"\n- \"How much of this connection's budget is left, and when does it reset?\"\n- \"Send 'summarize this in one line' to qwen-3.6-plus and tell me what it cost.\"\n- \"Show the top apps on Kyma rankings this week.\"\n\n## Troubleshooting\n\n- **Sign-in loops or \"connector failed\":** remove the connection and add it again; the client's stored token may belong to a revoked connection. Check [kymaapi.com/integrations](https://kymaapi.com/integrations) for the active list.\n- **`send_message` says the cap is reached:** raise the cap at kymaapi.com/integrations or wait for the 30-day window to reset; `get_spend` shows the date.\n- **A tool returns 403 insufficient scope:** the connection was approved without that optional scope. Reconnect and tick it on the approval screen.\n- **Stdio bridge cannot sign in:** set `KYMA_MCP_KEY` to a Kyma MCP key (`km-…`) created at kymaapi.com/integrations; REST `kyma-…` keys are rejected on purpose.\n- **Remote connections drop:** some clients need a reconnect after long idle periods; the server itself is stateless.\n\n## Registries and marketplaces\n\n- Official MCP Registry: `com.kymaapi/kyma` (`server.json` in this repo, published with `mcp-publisher`, namespace verified by DNS on kymaapi.com)\n- Smithery: `kyma-api/kyma`\n- npm stdio bridge: [`@kyma-api/mcp-server`](https://www.npmjs.com/package/@kyma-api/mcp-server)\n- Gemini CLI extensions gallery: `gemini-extension.json` and the repo topic `gemini-cli-extension`\n- Submitted, pending review: Cursor Marketplace, xAI Grok Build marketplace, Docker MCP Catalog, Cline Marketplace, mcp.so\n\n## About Kyma API\n\nKyma is an LLM API gateway: open and frontier models, one endpoint, pay per token, with automatic failover across providers and per-model measured uptime published at [kymaapi.com/models](https://kymaapi.com/models). New accounts start with free credit.\n\n- Website: https://kymaapi.com · This server's page: https://kymaapi.com/mcp · Docs: https://docs.kymaapi.com · Status: https://kymaapi.com/status\n- Support: hello@kymaapi.com · Abuse: report@kymaapi.com\n- Changelog: [CHANGELOG.md](https://github.com/kyma-api/kyma-mcp-plugin/blob/main/CHANGELOG.md) · License: MIT\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays","upstream",{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109},"requiredSecrets",[],"tags",[97],"assets",[],"stats",{"_95":59,"_96":59},"ratingAvg","reviewCount","gemini-cli-extension","topics",[97,115,116],"license","MIT","language","JavaScript","registryName","com.kymaapi/kyma","homepage","https://kymaapi.com","packages",[110],{"_111":112,"_113":114,"_75":76},"registryType","npm","identifier","@kyma-api/mcp-server","mcp","mcp-server","ENV",{"_119":120,"_121":122,"_123":124},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]