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.