helipod-mcp 0.1.0 → 0.2.0

package/README.md

@@ -5,6 +5,24 @@ Use [Helipod](https://helipod.io) from AI coding tools: deploy apps and database
 - **MCP server** (`helipod-mcp`): 70 tools over the Container, VPS, Domain and Email APIs. Works in Claude Code, Codex, Cursor, VS Code, Windsurf, Claude Desktop and any MCP client.
 - **Skills** (`skills/`): step-by-step playbooks so the agent deploys, prices and confirms the way Helipod expects (price first, confirm before deleting, read build logs on failure).
 
+Step-by-step guides for each tool (Claude Code, Codex, Cursor, VS Code, Gemini CLI, opencode, Windsurf, Claude Desktop, Cline and others): **https://docs.helipod.io/docs/helipod/ai-agents**
+
+## Quick start: sign in (no key)
+
+Add the hosted server and sign in to Helipod in the browser; you choose which products (Container, VPS, Domain API) and which project the tool may use, and can disconnect it any time in **Settings → API keys → Connected apps**.
+
+| Tool | Add | Sign in |
+|---|---|---|
+| Claude Code | `/plugin marketplace add helipodapp/mcp` then `/plugin install helipod@mcp` (or `claude mcp add --transport http helipod https://api.helipod.io/mcp`) | `/mcp` → helipod → Authenticate |
+| Codex | `[mcp_servers.helipod]` `url = "https://api.helipod.io/mcp"` in `~/.codex/config.toml` | `codex mcp login helipod` |
+| Cursor | `{"mcpServers":{"helipod":{"url":"https://api.helipod.io/mcp"}}}` in `~/.cursor/mcp.json` | Settings → MCP → Needs login |
+| opencode | `{"mcp":{"helipod":{"type":"remote","url":"https://api.helipod.io/mcp"}}}` | `opencode mcp auth helipod` |
+| Gemini CLI | `{"mcpServers":{"helipod":{"httpUrl":"https://api.helipod.io/mcp"}}}` | `/mcp auth helipod` |
+| VS Code | `{"servers":{"helipod":{"type":"http","url":"https://api.helipod.io/mcp"}}}` in `.vscode/mcp.json` | prompted when the server starts |
+| Claude.ai, ChatGPT | Add a custom connector with the URL `https://api.helipod.io/mcp` | prompted when connecting |
+
+Prefer a key, a local server, or a tool not listed? Read on.
+
 ## 1. Get a key
 
 In the [dashboard](https://helipod.io/project) open a project, then **Settings → API keys**. Choose the products (Container API, VPS API, Domain API) and the reach (one project, or the whole account; the Domain API needs a whole-account key). The key starts with `hel_`.
@@ -20,29 +38,29 @@ Start with a key limited to one project while you try things out.
 
 ## 2. Connect your tool
 
-The server runs with `npx -y github:helipodapp/mcp` (Node.js 18 or newer). Every config below starts it that way and passes `HELIPOD_API_KEY` from your environment.
+The server is the npm package `helipod-mcp` (Node.js 18 or newer). The configs below run it with `npx -y helipod-mcp` (or the installed `helipod-mcp` command) and pass `HELIPOD_API_KEY` from your environment.
 
-### Claude Code (plugin: MCP server + skills)
+### Claude Code
+
+The plugin (above) uses the hosted server with sign-in. Local server with a key instead:
 
 ```sh
-/plugin marketplace add helipodapp/mcp
-/plugin install helipod@mcp
+claude mcp add helipod --env HELIPOD_API_KEY=$HELIPOD_API_KEY -- npx -y helipod-mcp
 ```
 
-MCP server only:
+### Codex
+
+Install once (Codex does not wait for MCP servers to start, so an installed server is ready for the first message while `npx` can miss it):
 
 ```sh
-claude mcp add helipod --env HELIPOD_API_KEY=$HELIPOD_API_KEY -- npx -y github:helipodapp/mcp
+npm install -g helipod-mcp
 ```
 
-### Codex
-
 `~/.codex/config.toml`:
 
 ```toml
 [mcp_servers.helipod]
-command = "npx"
-args = ["-y", "github:helipodapp/mcp"]
+command = "helipod-mcp"
 env_vars = ["HELIPOD_API_KEY", "HELIPOD_EMAIL_API_KEY"]
 ```
 
@@ -55,7 +73,7 @@ env_vars = ["HELIPOD_API_KEY", "HELIPOD_EMAIL_API_KEY"]
   "mcpServers": {
     "helipod": {
       "command": "npx",
-      "args": ["-y", "github:helipodapp/mcp"],
+      "args": ["-y", "helipod-mcp"],
       "env": { "HELIPOD_API_KEY": "${env:HELIPOD_API_KEY}" }
     }
   }
@@ -71,7 +89,7 @@ env_vars = ["HELIPOD_API_KEY", "HELIPOD_EMAIL_API_KEY"]
   "mcpServers": {
     "helipod": {
       "command": "npx",
-      "args": ["-y", "github:helipodapp/mcp"],
+      "args": ["-y", "helipod-mcp"],
       "env": { "HELIPOD_API_KEY": "$HELIPOD_API_KEY" }
     }
   }
@@ -89,7 +107,7 @@ Gemini CLI only starts MCP servers in folders you have trusted.
   "mcp": {
     "helipod": {
       "type": "local",
-      "command": ["npx", "-y", "github:helipodapp/mcp"],
+      "command": ["npx", "-y", "helipod-mcp"],
       "environment": { "HELIPOD_API_KEY": "{env:HELIPOD_API_KEY}" }
     }
   }
@@ -107,7 +125,7 @@ Gemini CLI only starts MCP servers in folders you have trusted.
     "helipod": {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "github:helipodapp/mcp"],
+      "args": ["-y", "helipod-mcp"],
       "env": { "HELIPOD_API_KEY": "${input:helipod-key}" }
     }
   }
@@ -123,7 +141,7 @@ Gemini CLI only starts MCP servers in folders you have trusted.
   "mcpServers": {
     "helipod": {
       "command": "npx",
-      "args": ["-y", "github:helipodapp/mcp"],
+      "args": ["-y", "helipod-mcp"],
       "env": { "HELIPOD_API_KEY": "hel_..." }
     }
   }
@@ -132,7 +150,7 @@ Gemini CLI only starts MCP servers in folders you have trusted.
 
 ### Other clients
 
-Run `npx -y github:helipodapp/mcp` as a stdio MCP server with `HELIPOD_API_KEY` (and optionally `HELIPOD_EMAIL_API_KEY`) in its environment.
+Run `npx -y helipod-mcp` as a stdio MCP server with `HELIPOD_API_KEY` (and optionally `HELIPOD_EMAIL_API_KEY`) in its environment.
 
 ## Hosted server (nothing to install)
 

package/dist/http.js

@@ -36439,7 +36439,7 @@ var generalTools = [
 ];
 
 // src/server.ts
-var VERSION = "0.1.0";
+var VERSION = "0.2.0";
 var INSTRUCTIONS = `Helipod is a cloud platform (Indonesia): containers, VPS, domains, email and an AI gateway, billed from a prepaid wallet in Rupiah.
 - Start with list_projects to find projects and environment ids.
 - Anything that costs money (create/deploy/scale services, create/renew/upgrade VPS, register/renew/transfer domains): run the dryRun or price lookup first, tell the user the cost in IDR and wait for an explicit yes.

package/dist/index.js

@@ -35584,7 +35584,7 @@ var generalTools = [
 ];
 
 // src/server.ts
-var VERSION = "0.1.0";
+var VERSION = "0.2.0";
 var INSTRUCTIONS = `Helipod is a cloud platform (Indonesia): containers, VPS, domains, email and an AI gateway, billed from a prepaid wallet in Rupiah.
 - Start with list_projects to find projects and environment ids.
 - Anything that costs money (create/deploy/scale services, create/renew/upgrade VPS, register/renew/transfer domains): run the dryRun or price lookup first, tell the user the cost in IDR and wait for an explicit yes.

package/dist/stdio.js

@@ -35691,7 +35691,7 @@ var generalTools = [
 ];
 
 // src/server.ts
-var VERSION = "0.1.0";
+var VERSION = "0.2.0";
 var INSTRUCTIONS = `Helipod is a cloud platform (Indonesia): containers, VPS, domains, email and an AI gateway, billed from a prepaid wallet in Rupiah.
 - Start with list_projects to find projects and environment ids.
 - Anything that costs money (create/deploy/scale services, create/renew/upgrade VPS, register/renew/transfer domains): run the dryRun or price lookup first, tell the user the cost in IDR and wait for an explicit yes.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helipod-mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP server for Helipod: containers, VPS, domains and email from Claude Code, Codex, Cursor and other AI tools.",
   "type": "module",
   "bin": {