App Platform MCP server

Create apps from GitHub, deploy, stop and debug them, and manage their settings, straight from your assistant.

Server URL
https://api.kubana.cloud/mcp/app-platform
Transport
Streamable HTTP
Authentication
OAuth, sign in to Kubana
Tools
9 read, 18 write

Tools

What your assistant can do once connected, with the same permissions as your account.

ReadNothing in your account changes.
  • List and inspect apps
    See every app in your account with its status, domains and configuration.
    • list-apps
    • get-app
  • Read app logs
    Pull recent runtime logs to track down errors without leaving your editor.
    • get-app-logs
  • Deployments and build logs
    List deployments and read the build log of any of them.
    • list-deployments
    • get-deployment-logs
  • Frameworks, sizes and branches
    See the frameworks and versions you can deploy, sizes with prices, and your repository’s branches.
    • list-frameworks-and-sizes
    • list-branches
  • Environment variables and domains
    Read an app’s environment variables, its Kubana hostname and its custom domains.
    • list-environment-variables
    • list-domains
  • How it fits together
    Explain how App Platform connects to your other Kubana products and how it uses credits, based on your account.
Makes changesReview these when your assistant asks to run them. Tagged ones need a code Kubana emails you.
  • Create an app Approval code
    Create an app from a GitHub repository, then confirm its deploy key. Same limits as the dashboard.
    • create-app
    • confirm-deploy-key
  • Configure builds
    Set the branch, framework version and publish directory.
    • update-branch
    • update-framework-config
    • update-publish-directory
  • Post-deployment commands Approval code
    Change the commands that run after each deploy, such as migrations.
    • update-post-deployment-commands
  • Auto-deploy Approval code · turning on
    Turn deploy on push on or off. Turning it on gives your assistant the webhook URL and secret.
    • update-auto-deploy
  • Environment variables Approval code
    Add, change and delete an app’s environment variables.
    • set-environment-variables
    • update-environment-variable
    • delete-environment-variable
  • Custom domains Approval code
    Attach domains whose DNS already points at Kubana, choose the primary one and remove domains.
    • attach-domain
    • set-primary-domain
    • delete-domain
  • Deploy and roll back Approval code · first deploy
    Ship the latest commit (the first deploy starts billing), or redeploy an earlier one to roll back.
    • deploy-app
    • redeploy-deployment
  • Stop, terminate or delete Approval code
    Stop an app (it stays billed), terminate it to stop billing, or delete a terminated or never-deployed app.
    • stop-app
    • terminate-app
    • delete-app

By default, actions that cost money, take a site offline or touch secrets need your approval: Kubana emails you a one-time code, and the action runs only once you give that code to your assistant. You can change which actions ask under MCP Servers in the dashboard.

Approval codes

By default, before your assistant runs a tagged action, Kubana checks with you by email. Nothing changes until you hand over the code. You can change which actions ask under MCP Servers in the dashboard.

  1. 1. You ask
    For example: “Delete the DEBUG variable on my-api.”
  2. 2. Kubana emails you a code
    The “Approve an AI Agent Action” email names the action in plain words, its details and price, which assistant asked and when.
  3. 3. You give the code to your assistant
    Your assistant tells you it needs the code. Read it from the email and paste it in the chat.
  4. 4. The action runs
    Your assistant repeats the request with the code, and Kubana carries it out.
  • Each code works once, and only for the exact action in the email: the same app, server, domain or mailbox, with the same values.
  • Codes expire after 10 minutes and stop working after 5 wrong tries.
  • Kubana sends at most 5 codes every 10 minutes.
  • Actions you take in the dashboard never ask for a code.

Got a code you didn’t ask for? Ignore the email and revoke that assistant under MCP Servers in your dashboard.

Connect your assistant

The first time it connects, your assistant opens Kubana in your browser so you can sign in and approve access.

  1. Open Settings → Connectors and click “Add custom connector”.

  2. Name it Kubana and paste the server URL:

    Server URL
    https://api.kubana.cloud/mcp/app-platform
  3. Click Connect, sign in to Kubana and approve the access request.

Example prompts

  • Why did the last deployment of my API fail?
  • Show me the errors in my storefront logs from the past hour.
  • Set APP_DEBUG to false on my-api and redeploy it.
  • Roll my blog back to the commit before yesterday’s release.