Koyeb MCP Server: Interact with your Koyeb Resources in Natural Language
Today, we're announcing the Koyeb MCP Server in public beta to let you interact with your Koyeb resources in natural language.
Using the Koyeb MCP Server, LLMs and agents can easily discover and leverage Koyeb primitives to:
- Create and deploy applications in isolated environments from a local directory, GitHub repository, or container registry
- Update your Koyeb service configuration — including environment variables, instance type, scaling parameters, and more
- Execute commands on your Koyeb service instances
- Retrieve specific information about a service — from its status and configuration to its public and internal URLs
- Retrieve logs and metrics from your Koyeb services
All of this using your favorite AI assistants like Claude, Cursor, Windsurf or any other applications that support the Model Context Protocol.
Demo: Use Koyeb MCP Server to Deploy a New Service in Washington D.C. 🇺🇸
Using Cursor, you can now interact with the Koyeb platform. Here we asked Cursor to deploy a new service in Washington, D.C. and provide us the public URL.
In this demo, you can see the MCP server read the project files, use the deploy
feature to launch the service on Koyeb, and the list-apps
feature to retreive the public URL of the newly created service.
Getting started with the Koyeb MCP Server
To setup the Koyeb MCP Server, on most clients you need to add the following JSON configuration:
{
"mcpServers": {
"koyeb": {
"command": "npx",
"args": ["-y", "@koyeb/mcp-server"],
"env": {
"KOYEB_TOKEN": "<your-koyeb-token>"
}
}
}
}
or if you are using Cursor, you can use the following one-click setup:
You will need to create and replace <your-koyeb-token>
with a Koyeb API token. This API token is used to authenticate the Koyeb MCP Server to your Koyeb account. You can create a Koyeb API token in the Koyeb dashboard.
Once configured, your AI assistant will automatically discover the available Koyeb tools and can interact with your Koyeb resources using natural language.
Available Features with Koyeb MCP Server
As a part of this first release, here is what you can do with Koyeb MCP:
list-apps
: List all your Koyeb applicationsget-app
: Get details about a specific Koyeb applicationcreate-app
: Create a new Koyeb applicationlist-services
: List all your Koyeb services within an applicationget-service
: Get details about a specific Koyeb servicecreate-service
: Create a new Koyeb serviceupdate-service
: Update an existing Koyeb servicelist-deployments
: List all deployments of a Koyeb serviceget-deployment
: Get details about a specific Koyeb service deploymentlist-instances
: List all instances of a Koyeb serviceget-instance
: Get details about a specific Koyeb service instancelist-one-click-apps
: List all available one-click applicationsquery-logs
: Query logs for a specific Koyeb serviceexec
: Execute a command on a running Koyeb servicedeploy
: Deploy a directory
What's next?
The Koyeb MCP Server offers a way for agents to interact with your Koyeb resources. In its current state, the Koyeb MCP Servers provide a solid base of tools to help you manage the most common Koyeb resources. We plan to add more tools in the coming weeks, to provide a more complete experience and allow interacting with Volumes, Secrets, and more and provide a remote version of the server.
If you have any feedback or suggestions for the tools we should add or regarding your experience with the Koyeb MCP Server, please let us know on GitHub.