create-app
Create an app
LABSCO SUMMARY
Deploying, reading the build log and running a command in the container all happen in one place.
update-service works by creating a new deployment rather than mutating the running one, which is the model to hold on to when a configuration change does not appear immediately. query-logs covers build and runtime separately, so a failed build and a crashing process are distinguishable without guessing. exec is what turns a wrong-but-running service into something you can inspect, instead of redeploying repeatedly to find out what it sees.
What it is
A client for the Koyeb platform covering apps, services, deployments, instances, logs and command execution.
What you get
- Apps listed, fetched by ID and created; services listed, fetched, created inside an existing app, and updated by way of a new deployment.
- A local directory deployed to a named app and service.
- Deployments and instances listed and fetched individually.
- Build and runtime logs queried from the same tool.
- A command run inside a running deployment's instance, with a shell of your choosing.
- The one-click example applications available to deploy, and the API token currently in use.
Requirements
A Koyeb account with an API token in KOYEB_TOKEN.
Setup effort
One command plus a key — npx -y @koyeb/mcp-server, then supply credentials
USE CASES
01
Getting a local directory running on the platform
The deploy takes the directory, the app name and the service name; the service record is where you confirm what it became.
02
Working out why a deploy did not come up
The deployment record says what was attempted; the build log says where it stopped.
03
Diagnosing a service that is running but behaving wrongly
Running a command inside the live instance answers questions that logs alone leave open, without another deploy cycle.
04
Changing a service's configuration
An update is not applied in place — it produces a new deployment, which is what you watch to know the change took.
16 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
create-service
Create a new service inside an existing app
deploy
Deploy a directory to Koyeb
exec
Execute a command in a running deployment
get-app
Get an app by its id
get-deployment
Get a specific deployment by its id
get-instance
Get a specific instance by its id
get-service
Get a specific service by its id
get-token
Get the Koyeb API token
list-apps
List apps
list-deployments
Get the list of deployments
list-instances
Get the list of instances
list-one-click-apps
List one-click apps (example applications) that can be deployed on Koyeb
list-services
Get the list of services
query-logs
Get the build or runtime logs
update-service
Update a service's configuration by creating a new deployment
BEFORE YOU INSTALL
What to know first
Tools you get
16 tools when we connected. Secrets, volumes, domains, pause/resume, update app, cancel deployment, metrics and log tailing are listed as planned features and do not exist yet.
Requires
- npx on PATH
- KOYEB_TOKEN in your environment
Where it runs
Both documented clients run the server on your machine.
CONTEXT COST
Heavy Standing cost
Rated by the size of the 16 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y @koyeb/mcp-serverMCP Clients
Cursor, Claude Desktop
JSON
{
"mcpServers": {
"koyebApi": {
"command": "npx",
"args": [
"-y",
"@koyeb/mcp-server"
],
"env": {
"KOYEB_TOKEN": "<YOUR_KOYEB_TOKEN>"
}
}
}
}
