Universal Config
Every AI agent that supports OpenAI-compatible APIs works with Kyma. Here’s everything you need:/v1/models.
Auto-Detection
Kyma API keys start withkyma-. Configure:
Quick Verify
A new account’s $0.50 signup credit is added once the email is verified (Google sign-in counts as verified), and it spends on free tier models only. Models with
free_tier: false in /v1/models return 402 model_requires_paid until your first top-up. Every default on this page is in the free tier unless marked otherwise.Agent-Specific Configs
Claude Code / Claude CLI
Claude Code / Claude CLI
Claude Code speaks the Anthropic API, not an OpenAI-compatible one, and it
reads its configuration from the environment rather than from a JSON block
of provider settings:The base URL takes no
/v1 — Claude Code appends the path itself.Full setup, model choice and cost notes: Claude Code.Cursor IDE
Cursor IDE
Settings → OpenAI API:
- API Key:
kyma-your-api-key - Base URL:
https://kymaapi.com/v1 - Model:
qwen-3-coder(thecodealias)
Continue.dev
Continue.dev
OpenAI Python SDK
OpenAI Python SDK
OpenAI Node.js SDK
OpenAI Node.js SDK
LangChain
LangChain
Any OpenAI-compatible client
Any OpenAI-compatible client
Recommended Models
GET /v1/models shows free_tier for every model.
MCP Integration
Onboarding is one URL. Paste it into Claude, Cursor, Codex, or ChatGPT — OAuth login, no secret in the path:Authorization: Bearer with a Kyma MCP key from Integrations if they cannot OAuth. Do not put KYMA_API_KEY in client JSON for this flow. Read tools auto-allow; send_message is the spend/write tool and needs one Allow. The live catalog is GET /v1/models.
Clients that can only launch stdio servers run npx -y @kyma-api/mcp-server, a bridge to the same hosted URL: it signs in with OAuth in the browser, or skips the browser with KYMA_MCP_KEY=km-… (an MCP key, not a kyma- API key). See MCP Server.