Koyeb MCP Server

Note

Koyeb MCP is currently a beta pre-release. Feedback, bug reports, and contributions are welcome! Please open an issue or pull request.

Planned features: Secrets, volumes, domains, pause/resume, update app, cancel deployment, metrics, log tailing

A Model Context Protocol (MCP) server implementation for the Koyeb API. This project enables programmatic management of Koyeb resources (apps, services, deployments, instances, logs, and more) via the MCP protocol.

Features

• App Management

  • List, get, and create Koyeb apps

• Service Management

  • List, get, create, and update services within apps

• Deployment Management

  • List and get deployments, query build/runtime logs

• Instance Management

  • List and get instances for deployments/services

• One-Click Apps

  • List available one-click (example) apps on Koyeb

Adding MCP config to your client

Add the following to your .cursor/mcp.json or claude_desktop_config.json.

{
  "mcpServers": {
    "koyebApi": {
      "command": "npx",
      "args": ["-y", "@koyeb/mcp-server"],
      "env": {
        "KOYEB_TOKEN": "your_token_here"
      }
    }
  }
}

CLI usage

1. Install the package from npmjs:

npm install -g @koyeb/mcp-server

2. Set your Koyeb API token:

Create a token at Koyeb API settings and export it:

export KOYEB_TOKEN=your_token_here

3. Start the MCP server:

koyeb-mcp

The server will connect via stdio and expose the Koyeb API as MCP tools.

License

MIT