Jul 24, 2025
3 min read

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:

Install MCP Server

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 applications
  • get-app: Get details about a specific Koyeb application
  • create-app: Create a new Koyeb application
  • list-services: List all your Koyeb services within an application
  • get-service: Get details about a specific Koyeb service
  • create-service: Create a new Koyeb service
  • update-service: Update an existing Koyeb service
  • list-deployments: List all deployments of a Koyeb service
  • get-deployment: Get details about a specific Koyeb service deployment
  • list-instances: List all instances of a Koyeb service
  • get-instance: Get details about a specific Koyeb service instance
  • list-one-click-apps: List all available one-click applications
  • query-logs: Query logs for a specific Koyeb service
  • exec: Execute a command on a running Koyeb service
  • deploy: 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.


Deploy AI apps to production in minutes

Get started
Koyeb is a developer-friendly serverless platform to deploy apps globally. No-ops, servers, or infrastructure management.
All systems operational
© Koyeb