Koompi Cloud MCP Server

KOOMPI Cloud — MCP Server & Gemini CLI Extension

Connect Claude, ChatGPT, and Gemini CLI to KOOMPI Cloud (https://mcp.koompi.ai/) to build, preview, and deploy web apps, GitHub repositories, Docker images, managed databases (PostgreSQL, MySQL, MariaDB, MongoDB, Redis, SQL Server, Turso), message brokers, Linux VPS instances, S3-compatible object storage, and custom domains.

---

Quick Install

1. Claude (Claude.ai, Claude Desktop & Claude Code)

Claude Code plugin (connector plus KOOMPI Cloud skills and a /koompi-cloud:deploy command):

/plugin install koompi-cloud --marketplace koompi/koompi-cloud-mcp

On Claude Code older than 2.1.275, run /plugin marketplace add koompi/koompi-cloud-mcp, then /plugin install koompi-cloud@koompi.

Connector only:

claude mcp add --transport http koompi-cloud https://mcp.koompi.ai/

Either way, run /mcp inside Claude Code to sign in with your KOOMPI ID.

To use an API token instead of signing in (created in KOOMPI Cloud › Settings › API Tokens), add this to .mcp.json:

{
  "mcpServers": {
    "koompi-cloud": {
      "type": "http",
      "url": "https://mcp.koompi.ai/",
      "headers": { "Authorization": "Bearer ${KOOMPI_CLOUD_TOKEN}" }
    }
  }
}

In Claude.ai / Claude Desktop:

1. Open Settings › Connectors › Add custom connector.
2. Name: KOOMPI Cloud, URL: https://mcp.koompi.ai/.
3. Sign in with your KOOMPI account and select an organization.

2. Gemini CLI Extension

gemini extensions install https://github.com/koompi/koompi-cloud-mcp

Set your API token (created in KOOMPI Cloud › Settings › API Tokens):

export KOOMPI_CLOUD_TOKEN="kp_..."

Use the /deploy slash command or natural language prompts in gemini.

3. ChatGPT

Enable Developer Mode in Settings › Apps & Connectors, create a connector with URL https://mcp.koompi.ai/, and sign in with OAuth.

---

Repository Contents

• server.json — Official MCP Registry manifest (io.github.koompi/koompi-cloud).
• gemini-extension.json, GEMINI.md, commands/deploy.toml — Gemini CLI extension manifest, context instructions, and /deploy command.
• .claude-plugin/marketplace.json, plugins/koompi-cloud/ — Claude Code marketplace (koompi) and plugin (koompi-cloud).
• tool-annotations.json — MCP tool annotations (title, readOnlyHint, destructiveHint, openWorldHint) for all 71 tools, for the backend to serve.
• openapi.yaml — Reference catalog of all 71 tools with input schemas and read-only vs. write classification. Not importable as Custom GPT Actions (the server only exposes MCP at POST /).
• deploy/nginx-mcp.koompi.ai.conf — OpenResty/Nginx routing for mcp.koompi.ai.
• parse_koompi_mcp.py — Health check for the live endpoint and OAuth discovery (uv run parse_koompi_mcp.py).
• SUBMISSION_GUIDE.md — Directory listing status and submission steps.
• TEAM_MIGRATION_PROMPT.md — Server and backend changes required for mcp.koompi.ai.

License

Apache-2.0