# Kyma API

Kyma API gives an AI agent model prices, rankings, and measured uptime. It can also send model requests under a spending cap.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: kyma-api
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/kyma-api/kyma-mcp-plugin
- Updated: 2026-09-14
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/kyma-api

## What it does

The server connects an agent to Kyma API’s model catalog. It can retrieve pricing and model details, rankings based on real traffic, and measured uptime. Read requests are free.

The `send_message` tool sends a prompt to a model after the client approves the call. The server checks the estimated cost against the connection’s cap before sending; the default dedicated key limit is $10 per 30 days. HTTP connections use OAuth, so you don’t paste an API key into the client. For a stdio setup, you need `KYMA_MCP_KEY`, which means configuring a separate key for that connection.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.kymaapi.com/mcp`
- Environment variables: `KYMA_MCP_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http kyma https://mcp.kymaapi.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env KYMA_MCP_KEY=<KYMA_MCP_KEY> --transport stdio kyma-api -- npx -y @kyma-api/mcp-server
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add kyma-api --url https://mcp.kymaapi.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add kyma-api --env KYMA_MCP_KEY=<KYMA_MCP_KEY> -- npx -y @kyma-api/mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "kyma-api": {
            "url": "https://mcp.kymaapi.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "kyma-api": {
            "command": "npx",
            "args": [
                "-y",
                "@kyma-api/mcp-server"
            ],
            "env": {
                "KYMA_MCP_KEY": "<KYMA_MCP_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "kyma-api": {
            "type": "http",
            "url": "https://mcp.kymaapi.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "kyma-api": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@kyma-api/mcp-server"
            ],
            "env": {
                "KYMA_MCP_KEY": "<KYMA_MCP_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http kyma-api https://mcp.kymaapi.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e KYMA_MCP_KEY=<KYMA_MCP_KEY> kyma-api npx -y @kyma-api/mcp-server
```
Replace <…> with your own values

## When to use it
- compare model prices and context windows
- find highly ranked models from real traffic
- check a model’s measured uptime
- send a model request within a spending cap

## Example prompts
- List available models and compare their prices.
- Check the measured uptime for this model.
- Send a request to a model without exceeding the spending cap.

## Similar
- [gemini-api-dev](https://affpapa.org/en/nevibecode/skills/gemini-api-dev.md) — skill · 27800 installs
- [siliconflow-api-skills](https://affpapa.org/en/nevibecode/skills/siliconflow-api-skills.md) — skill · ★ 297 repo stars
- [venice-api-overview](https://affpapa.org/en/nevibecode/skills/venice-api-overview.md) — skill · ★ 176 repo stars
- [claude-api](https://affpapa.org/en/nevibecode/skills/claude-api.md) — skill · 74198 installs
- [x402engine](https://affpapa.org/en/nevibecode/mcp/x402engine.md) — MCP server · 2810 installs
- [omni-combos-routing](https://affpapa.org/en/nevibecode/skills/omni-combos-routing.md) — skill · 1600 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
