Add it to Claude Code
claude mcp add -e "KOYEB_TOKEN=${KOYEB_TOKEN}" koyeb -- npx -y @koyeb/mcp-serverKOYEB_TOKENMake your agent remember this setup
koyeb's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- List, get, and create Koyeb applications
- Manage services within apps including creation and updates
- Query build and runtime logs for specific deployments
- List and inspect instances for deployments and services
- List available one-click example apps
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 settingsTry it
Original README from samihalawa/mcp-server-koyeb
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