@shipstatic/mcp 0.4.8 → 0.5.0

package/README.md

@@ -1,12 +1,48 @@
 # @shipstatic/mcp
 
-MCP server for [ShipStatic](https://shipstatic.com) — deploy static websites, landing pages, and prototypes instantly from AI agents.
+ShipStatic MCP — deploy static websites, landing pages, and prototypes from AI agents.
+
+**One URL. Your agent ships.**
 
 <a href="https://glama.ai/mcp/servers/@shipstatic/shipstatic">
   <img width="380" height="200" src="https://glama.ai/mcp/servers/@shipstatic/shipstatic/badge" alt="shipstatic MCP server" />
 </a>
 
-## Setup
+## Hosted — no install
+
+Drop this URL into any MCP client. Your agent can publish a website in its next message — free, no install, no signup, no API key.
+
+```
+https://mcp.shipstatic.com
+```
+
+### Claude Code
+
+```bash
+claude mcp add --transport http shipstatic https://mcp.shipstatic.com
+```
+
+### Cursor, Antigravity, Windsurf, Zed — anywhere with `mcp.json`
+
+```json
+{
+  "mcpServers": {
+    "shipstatic": {
+      "url": "https://mcp.shipstatic.com"
+    }
+  }
+}
+```
+
+### Claude Desktop, Claude.ai web
+
+Add a custom connector pointing at `https://mcp.shipstatic.com`.
+
+The hosted endpoint exposes one tool: `deployments_upload`. Public deployments expire in 3 days unless claimed — the response includes a claim URL the user can visit to keep the site permanently. Set a `password` arg to gate the deployment behind an unlock prompt.
+
+## Local — full toolset
+
+Install this package when you need to manage deployments, link custom domains, or use account-tied operations.
 
 ### Claude Code
 
@@ -46,42 +82,38 @@ Add to `~/.gemini/antigravity/mcp_config.json`:
 
 ### Windsurf, Zed, and other MCP clients
 
-Same config format — `npx @shipstatic/mcp` via stdio. Works with any MCP-compatible client.
+Same config format — `npx @shipstatic/mcp`. Works with any MCP-compatible client.
 
-## Deploy — Free, No Account Needed
+## Free API key — permanent deployments
 
-Ask your AI agent to deploy a site. No API key, no sign-up, no configuration.
+`SHIP_API_KEY` is optional. Without it, deploys behave like the hosted endpoint (public, claim URL, 3-day expiry). With it, you get permanent deployments, the full toolset, and bigger limits.
 
-Your site is live instantly on `*.shipstatic.com`.
-
-Deployments without an API key are public and expire in 3 days. The response includes a **claim URL** — always show it to the user so they can keep the site permanently.
-
-Want a private site? Ask your agent to set a password when deploying — visitors will be prompted to unlock before viewing, on the deployment URL and on any custom domains pointing at it.
-
-## All Tools — Free API Key
-
-For permanent deployments and full control over your sites and domains, add a free API key from [my.shipstatic.com/api-key](https://my.shipstatic.com/api-key):
+Get a free key at [my.shipstatic.com/api-key](https://my.shipstatic.com/api-key):
 
 ```bash
 claude mcp add shipstatic -e SHIP_API_KEY=ship-... -- npx @shipstatic/mcp
 ```
 
+## Tools
+
+The hosted endpoint exposes `deployments_upload` only. The local install exposes everything below.
+
 ### Deployments
 
-| Tool | Description |
-|------|-------------|
-| `deployments_upload` | Publish files and get a live URL instantly, optionally protected by a password |
-| `deployments_list` | List all deployments with their URLs, status, labels, and password protection state |
-| `deployments_get` | Get deployment details including URL, status, file count, size, labels, and password protection state |
-| `deployments_set` | Update the labels on a deployment for organization and filtering |
-| `deployments_remove` | Permanently remove a deployment and all its files |
+| Tool | Description | Hosted |
+|------|-------------|:---:|
+| `deployments_upload` | Publish files and get a live URL instantly, optionally protected by a password | ✓ |
+| `deployments_list` | List all deployments with their URLs, status, labels, and password protection state | |
+| `deployments_get` | Get deployment details including URL, status, file count, size, labels, and password protection state | |
+| `deployments_set` | Update the labels on a deployment for organization and filtering | |
+| `deployments_remove` | Permanently remove a deployment and all its files | |
 
 ### Domains
 
 | Tool | Description |
 |------|-------------|
 | `domains_set` | Connect a custom domain to your site, switch deployments, or update labels |
-| `domains_list` | List all domains with their linked deployments and verification status |
+| `domains_list` | List all domains with their linked deployment and verification status |
 | `domains_get` | Get domain details including linked deployment, verification status, and labels |
 | `domains_records` | Get the DNS records you need to configure at your DNS provider |
 | `domains_dns` | Look up which DNS provider hosts a domain (e.g. Cloudflare, Namecheap) |
@@ -98,7 +130,7 @@ claude mcp add shipstatic -e SHIP_API_KEY=ship-... -- npx @shipstatic/mcp
 
 ## Registry
 
-Published to the [MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=com.shipstatic/mcp) as `com.shipstatic/mcp`.
+Published to the [MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=com.shipstatic/mcp) as `com.shipstatic/mcp`. Registry-aware clients see both the hosted endpoint and the local install and pick the right transport for their environment.
 
 ## License
 

package/dist/server.js

@@ -76,7 +76,7 @@ export function createServer(ship) {
         },
     }, ({ domain, deployment, labels }) => call(() => ship.domains.set(domain, { deployment, labels })));
     server.registerTool('domains_list', {
-        description: 'List all domains with their URLs, linked deployments, and verification status.',
+        description: 'List all domains with their URLs, linked deployment, and verification status.',
         annotations: READ,
     }, () => call(() => ship.domains.list()));
     server.registerTool('domains_get', {

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@shipstatic/mcp",
-  "version": "0.4.8",
+  "version": "0.5.0",
   "mcpName": "com.shipstatic/mcp",
-  "description": "Free, no account needed — deploy static websites, landing pages, and prototypes instantly from AI agents",
+  "description": "ShipStatic MCP — deploy static websites from AI agents. Full toolset incl. custom domains. Free hosted endpoint at mcp.shipstatic.com — no install.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",