Using Koyeb with Coding Agents

Coding agents can interact with Koyeb to create apps, manage services, and inspect deployments without leaving your editor. There are two integration paths:

Agent Skills: a skill pack that adds Koyeb actions directly to supported coding agents.
MCP server: a Model Context Protocol server that exposes Koyeb API operations as tools your agent can call.

Agent Skills

Agent Skills provide a curated set of Koyeb actions (for example, managing apps and services) that your coding agent can invoke. This is the simplest option when your agent already supports Skills. Koyeb Agent Skills include sandbox functionality, allowing your coding agents to create and run code in isolated, ephemeral environments.

The skills are authored in the Agent Skills open format and work with Agent Skills-compatible products, including VS Code, Cursor, Codex, Mistral Vibe, Claude Code, and OpenCode.

Example prompts:

Deploy this app on Koyeb in the Washington region on a medium instance
Do I have any unhealthy Koyeb services?
Why did this deployment to Koyeb fail?
When was my app last deployed on Koyeb?

Example sandbox prompt:

Create a Python app that creates a Koyeb sandbox using an A100 instance, downloads and installs Ollama, and then uses Ollama to pull codellama and run the prompt “Write a Python function to calculate prime numbers”. Display the code for the client, and also run it to test it, all in the sandbox. Keep the sandbox running until the program ends. Log errors and streams so you can troubleshoot as needed.

Install the skills

You can manually install the skills by copying the skills folder into your agent’s skills directory. This lets you pick the exact skills you want, and you can re-run the copy process to update.

Copy the following folder into your agent’s skills directory:

plugins/koyeb/skills/

If your agent uses a custom skills directory or import flow, follow that product’s documentation and point it at plugins/koyeb/skills.

Common locations for local installs include:

Claude: ~/.claude/skills/
Codex: ~/.codex/skills/
OpenCode: ~/.config/opencode/skill/
Cursor: ~/.cursor/skills/

Available skills

setup
apps
archives
deploy
domains
organizations
secrets
services
deployments
instances
databases
sandboxes-js-sdk
sandboxes-python-sdk
version
volumes

Refer to the repository for installation steps, authentication requirements, and the full skill documentation:

https://github.com/koyeb/koyeb-skills

MCP server

The Koyeb MCP server implements the Model Context Protocol to make the Koyeb API available as tools. This is a good fit if your agent supports MCP clients.

Available capabilities include:

App management (list, get, create)
Service management (list, get, create, update)
Deployment management (list, get, build/runtime logs)
Instance management (list, get)
One-click apps (list available examples)

Configure an MCP client

Add the MCP server configuration to your client (for example, Cursor or Claude Desktop) and provide a Koyeb API token via the KOYEB_TOKEN environment variable:


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

Create a token in the Koyeb console under API settings and replace the value in the configuration above.

Run the MCP server locally

If you prefer to run the server yourself:

Install the package:

npm install -g @koyeb/mcp-server
Export your token:

export KOYEB_TOKEN=your_token_here
Start the server:

koyeb-mcp

Repository and documentation:

https://github.com/koyeb/mcp-server-koyeb