Access Kyma Models from Claude Code with Kyma's MCP Server

April 12, 20262 min read

The Problem

Claude Code and Cursor are powerful. But sometimes you want to use a different model for a specific task — DeepSeek R1 for reasoning, Qwen 3.6 Plus for general quality, or Gemini 2.5 Flash for processing a massive codebase.

With Kyma's MCP server, you can access Kyma's active models directly from your AI coding tool. No switching windows, no separate API calls.

Setup (2 Minutes)

Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "kyma": {
      "command": "npx",
      "args": ["@kyma-api/mcp-server"],
      "env": {
        "KYMA_API_KEY": "ky-your-api-key"
      }
    }
  }
}

Restart Claude Code. Done.

Cursor

Add to Cursor's MCP settings (Settings > MCP):

{
  "kyma": {
    "command": "npx",
    "args": ["@kyma-api/mcp-server"],
    "env": {
      "KYMA_API_KEY": "ky-your-api-key"
    }
  }
}

What You Can Do

The MCP server exposes two tools:

`chat` — Talk to Any Model

Ask your AI assistant to use Kyma for specific tasks:

•"Use kyma chat with deepseek-r1 to analyze this algorithm's time complexity"
•"Use kyma chat with qwen-3-32b to refactor this function"
•"Use kyma chat with gemini-2.5-flash to summarize this entire file"

`list_models` — See Available Models

"Use kyma list_models to show me what's available"

Returns Kyma's active models with their IDs and providers.

When to Use Which Model

Task	Model	Why
Code review	`deepseek-v3`	Strong code understanding, best value
Reasoning/math	`deepseek-r1`	Chain-of-thought, 96% cheaper than o1
General quality	`qwen-3.6-plus`	#1 most popular on Kyma
Fast iteration	`qwen-3-32b`	Ultra-fast responses
Large files	`gemini-2.5-flash`	1M context window
Agentic tasks	`kimi-k2.5`	Best tool calling support

How It Works

The MCP server runs locally via npx. When your AI tool calls a Kyma tool, the server:

•Receives the request via stdio
•Forwards it to https://kymaapi.com/v1/chat/completions
•Returns the response to your AI tool

Your API key stays local. No data is stored on Kyma's servers beyond what's needed for the request.

Cost

With $0.50 free credits on signup, you get hundreds of MCP tool calls. A typical code review request costs about $0.002.

Get your API key at kymaapi.com and set it up in under 2 minutes.