Programmatic management of Koyeb resources via the Model Context Protocol.
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
- Install the package from npmjs:
npm install -g @koyeb/mcp-server
- Set your Koyeb API token:
Create a token at Koyeb API settings and export it:
export KOYEB_TOKEN=your_token_here
- Start the MCP server:
koyeb-mcp
The server will connect via stdio and expose the Koyeb API as MCP tools.
License
MIT
Tools (5)
list_appsList all Koyeb applicationsget_appGet details for a specific Koyeb applicationlist_servicesList services within a specific Koyeb applicationlist_deploymentsList deployments for a specific serviceget_logsQuery build or runtime logs for a deploymentEnvironment Variables
KOYEB_TOKENrequiredAPI token generated from Koyeb user settingsConfiguration
{"mcpServers": {"koyebApi": {"command": "npx", "args": ["-y", "@koyeb/mcp-server"], "env": {"KOYEB_TOKEN": "your_token_here"}}}}