helipod-mcp 0.1.0 → 0.1.1

package/README.md

@@ -5,6 +5,8 @@ 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**
+
 ## 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,7 +22,7 @@ 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)
 
@@ -32,17 +34,22 @@ The server runs with `npx -y github:helipodapp/mcp` (Node.js 18 or newer). Every
 MCP server only:
 
 ```sh
-claude mcp add helipod --env HELIPOD_API_KEY=$HELIPOD_API_KEY -- npx -y github:helipodapp/mcp
+claude mcp add helipod --env HELIPOD_API_KEY=$HELIPOD_API_KEY -- npx -y helipod-mcp
 ```
 
 ### 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
+npm install -g helipod-mcp
+```
+
 `~/.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 +62,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 +78,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 +96,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 +114,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 +130,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 +139,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.1.1";
 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.1.1";
 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.1.1";
 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.1.1",
   "description": "MCP server for Helipod: containers, VPS, domains and email from Claude Code, Codex, Cursor and other AI tools.",
   "type": "module",
   "bin": {