Korpi API MCP server

Local stdio MCP server for the Korpi API: every top AI video, image and text model behind one API, one key and one bill. It gives Claude, Cursor and other MCP clients five tools:

Paid tools charge the prepaid API balance. Prices come from list_models.

Key

Create a korpi_api_ key at https://korpi.ai/developers?section=keys and pass it as KORPI_API_KEY, or save it in ~/.korpi/api.json:

{ "apiKey": "korpi_api_..." }

The server never logs or prints the key, sends it only to the Korpi API over HTTPS, and redacts anything shaped like a key from tool output and errors.

Related MCP server: Createya MCP & API

Install

Claude Code:

claude mcp add korpi -e KORPI_API_KEY=korpi_api_... -- npx @korpiai/api-mcp

Other clients (.cursor/mcp.json, claude_desktop_config.json, Windsurf, VS Code):

{
  "mcpServers": {
    "korpi": {
      "command": "npx",
      "args": ["@korpiai/api-mcp"],
      "env": { "KORPI_API_KEY": "korpi_api_..." }
    }
  }
}

From a checkout: node bin/korpi-api-mcp.mjs.

Cursor plugin: this repo is also a Cursor plugin (.cursor-plugin/plugin.json and mcp.json). It reads KORPI_API_KEY from your environment.

Develop

npm test            # unit tests, mocked API
npm run smoke       # spawns the bin over stdio against a local mock API
npx -y @modelcontextprotocol/inspector --cli node bin/korpi-api-mcp.mjs --method tools/list

Release: bump version in package.json, server.json, the bin, src/server.mjs and src/client.mjs together, then npm publish (prepublishOnly runs the tests and the stdio smoke) and mcp-publisher publish to update the MCP registry entry io.github.Reksely/korpi-api-mcp.

License

MIT, see LICENSE.