Skip to main content
Glama

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.

CI npm

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.

Related MCP server: firepass-mcp

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.

Related MCP Connectors

Related MCP Servers