Skip to main content

Universal Config

Every AI agent that supports OpenAI-compatible APIs works with Kyma. Here’s everything you need:
That’s it. Two values. Everything else is auto-discovered via /v1/models.

Auto-Detection

Kyma API keys start with kyma-. Configure:

Quick Verify

Returns all available models. Pick any one.
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 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.
Settings → OpenAI API:
  • API Key: kyma-your-api-key
  • Base URL: https://kymaapi.com/v1
  • Model: qwen-3-coder (the code alias)
~/.continue/config.yaml:
More roles and models: Continue.dev.
Works with: Hermes, OpenClaw, Aider, Cline, Windsurf, LibreChat, anything OpenAI-compatible.
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:
Grok and Perplexity use the same URL plus 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.