kimi-api-mcp

MCP server for Kimi K2.5 via the Moonshot REST API — no CLI installation or subscription required. Just a Moonshot API key.

Works with Claude Code, Cursor, VS Code, Windsurf, Claude Desktop, and any MCP-compatible host.

Why

The official kimi-code-mcp package requires the Kimi Code CLI binary and a paid subscription. This package calls the Moonshot API directly using your existing API key — no binary, no subscription.

Install

No install needed with npx:

npx kimi-api-mcp@latest

Or install globally:

npm install -g kimi-api-mcp

Setup

1. Get an API key from platform.moonshot.ai (free tier available)
2. Add to your MCP config

Claude Code (~/.claude/mcp.json)

{
  "mcpServers": {
    "kimi-code": {
      "command": "npx",
      "args": ["-y", "kimi-api-mcp@latest"],
      "env": {
        "MOONSHOT_API_KEY": "your-moonshot-api-key"
      }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "kimi": {
      "command": "npx",
      "args": ["-y", "kimi-api-mcp@latest"],
      "env": {
        "MOONSHOT_API_KEY": "your-moonshot-api-key"
      }
    }
  }
}

VS Code / Windsurf

Add the same mcpServers block to your MCP settings file.

Tools

Local tier — free, no LLM calls

Tool	Description
kimi_read_file	Read a text file (with offset/limit)
kimi_write_file	Create or overwrite a file
kimi_edit_file	Find-and-replace in a file
kimi_glob	Find files matching a glob pattern
kimi_grep	Search files with regex (uses rg or grep)
kimi_shell	Execute a shell command (120s timeout)
kimi_fetch_url	Fetch and extract text from a URL

Moonshot API tier — uses moonshot-v1-128k (~$0.60/M tokens)

Tool	Description
kimi_think	Extended step-by-step reasoning
kimi_review	Code review (bugs, security, performance)
kimi_test	Generate or improve tests
kimi_research	Analyze a codebase with 128K context
kimi_read_media	Analyze images via vision API
kimi_web_search	Web search + AI summary
kimi_agent	Autonomous multi-step agent (up to 15 iterations)

Environment Variables

Variable	Required	Description
MOONSHOT_API_KEY	Yes	Your Moonshot API key from platform.moonshot.ai

Requirements

• Node.js 18+
• A Moonshot API key (for API-tier tools)

Contributing

See CONTRIBUTING.md.

License

MIT — see LICENSE.