mcp -koyeb

This MCP server provides programmatic access to the Koyeb API via the MCP protocol. It exposes tools to manage apps, services, deployments, and instances in Koyeb through MCP commands, enabling you to automate typical workflows such as listing and creating apps, managing services within apps, querying deployments and their logs, and inspecting deployment instances. To begin, install the MCP server globally with npm and obtain a Koyeb API token. Once running, the MCP client can discover and invoke the corresponding Koyeb API capabilities as standard MCP tools, streamlining integration with other automation or orchestration systems.

Prerequisites:

• Node.js and npm installed
• An active Koyeb API token

Step-by-step:

1. Install the MCP server package globally: npm install -g @koyeb/mcp-server

2. Obtain a Koyeb API token from your Koyeb account settings and export it (or set it in the mcp config): export KOYEB_TOKEN=your_token_here

3. Run or configure the MCP server through your MCP client using the provided example (see mcp_config). For direct run, you can start the server via the client invocation that loads the MCP server from npm: koyeb-mcp

4. Verify access by listing resources (apps, services, deployments) through the MCP tools exposed by the server.

Tips:

• Keep your KOYEB_TOKEN secure; do not commit it in code.
• If you regenerate tokens, update the environment variable in your MCP config.
• The MCP server exposes basic app/service/deployment management; for advanced features (secrets, volumes, domains, metrics), monitor for beta features and adjust config accordingly.
• Ensure network access to Koyeb API is permitted by your environment.
• If you encounter token-related errors, re-export KOYEB_TOKEN in the shell or container running the MCP client.