@shipstatic/mcp 0.2.0 → 0.4.0

package/README.md

@@ -1,10 +1,8 @@
 # @shipstatic/mcp
 
-MCP server for [ShipStatic](https://shipstatic.com) - deploy and manage static sites from AI agents.
+MCP server for [ShipStatic](https://shipstatic.com) — deploy static sites instantly from AI agents. No account required.
 
-ShipStatic is a simpler alternative to Vercel and Netlify, specialized for static website hosting. No build steps, no framework lock-in - just upload your files and get a URL.
-
-Works with Claude Code, Cursor, VS Code Copilot, and any MCP-compatible client.
+Works with Claude Code, Cursor, VS Code Copilot, and any MCP-compatible client. Deployments are live immediately — no setup, no credentials needed.
 
 <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" />
@@ -15,28 +13,50 @@ Works with Claude Code, Cursor, VS Code Copilot, and any MCP-compatible client.
 ### Claude Code
 
 ```bash
-claude mcp add shipstatic -e SHIP_API_KEY=ship-... -- npx @shipstatic/mcp
+claude mcp add shipstatic -- npx @shipstatic/mcp
 ```
 
-### Other MCP clients
+### Cursor
 
-Add to your MCP client configuration:
+Add to `~/.cursor/mcp.json`:
 
 ```json
 {
   "mcpServers": {
     "shipstatic": {
       "command": "npx",
-      "args": ["@shipstatic/mcp"],
-      "env": {
-        "SHIP_API_KEY": "ship-..."
-      }
+      "args": ["@shipstatic/mcp"]
     }
   }
 }
 ```
 
-Get your API key at [my.shipstatic.com](https://my.shipstatic.com).
+### Windsurf
+
+Add to `~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "shipstatic": {
+      "command": "npx",
+      "args": ["@shipstatic/mcp"]
+    }
+  }
+}
+```
+
+### Other MCP clients
+
+Same config format — `npx @shipstatic/mcp` via stdio.
+
+That's it. Deployments work immediately — sites are live with a claim URL (3-day TTL).
+
+For permanent deployments, add a free API key from [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
 

package/dist/call.js

@@ -14,8 +14,8 @@ export async function call(fn) {
 function handleError(error) {
     if (isShipError(error)) {
         let message = error.message;
-        if (error.isType(ErrorType.Authentication)) {
-            message += '\n\nHint: Set the SHIP_API_KEY environment variable in your MCP server configuration.';
+        if (error.isType(ErrorType.Authentication) && !message.includes('Too many requests')) {
+            message += '\n\nHint: Set a free SHIP_API_KEY environment variable in your MCP server configuration.';
         }
         if (error.isType(ErrorType.Validation) && error.details) {
             message += `\n\nDetails: ${JSON.stringify(error.details)}`;

package/dist/index.js

@@ -3,22 +3,9 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import Ship from '@shipstatic/ship';
 import { createServer } from './server.js';
 const apiKey = process.env.SHIP_API_KEY;
-if (!apiKey) {
-    console.error('SHIP_API_KEY environment variable is required.');
-    console.error('Add to your MCP client config:\n');
-    console.error(JSON.stringify({
-        mcpServers: {
-            shipstatic: {
-                command: 'npx',
-                args: ['@shipstatic/mcp'],
-                env: { SHIP_API_KEY: 'ship-...' },
-            },
-        },
-    }, null, 2));
-    process.exit(1);
-}
 async function main() {
-    const server = createServer(new Ship({ apiKey }));
+    const ship = apiKey ? new Ship({ apiKey }) : new Ship({});
+    const server = createServer(ship);
     const transport = new StdioServerTransport();
     await server.connect(transport);
     console.error('ShipStatic MCP Server running on stdio');

package/dist/server.js

@@ -6,15 +6,19 @@ const READ = { readOnlyHint: true, destructiveHint: false, idempotentHint: true,
 const CREATE = { destructiveHint: false, ...OPEN_WORLD };
 const WRITE = { destructiveHint: false, idempotentHint: true, ...OPEN_WORLD };
 const DESTRUCTIVE = { destructiveHint: true, idempotentHint: true, ...OPEN_WORLD };
-const INSTRUCTIONS = `ShipStatic hosts static websites.
+const INSTRUCTIONS = `ShipStatic deploys static websites instantly. No account required.
 
-Concepts:
-- Deployment: an immutable set of uploaded files. Every deployment gets a permanent URL (e.g. happy-cat-abc1234.shipstatic.dev) immediately — no domain setup needed.
-- Domain: a custom domain (e.g. www.example.com) that points to a deployment. Optional. Only subdomains are supported (www.example.com, blog.example.com) — not apex domains (example.com).
+To deploy: call deployments_upload with the build output directory path. The site is live immediately.
+
+Without SHIP_API_KEY, deployments are public and expire in 3 days. The response includes a claim URL — always show the deployment URL and the claim URL to the user so they can keep the site permanently.
 
-To deploy a site: call deployments_upload with the absolute path to the build output directory. The response includes the live URL.
+With SHIP_API_KEY configured, deployments go to the user's account and never expire. Listing, managing, and domain operations also require SHIP_API_KEY.
+
+Concepts:
+- Deployment: an immutable set of files with an instant URL (e.g. happy-cat-abc1234.shipstatic.com). No setup needed.
+- Domain: a custom domain (e.g. www.example.com) pointing to a deployment. Optional. Subdomains only — not apex domains.
 
-To add a custom domain: domains_validate → domains_set (with the deployment ID) → domains_records (show the DNS records to the user) → user configures DNS → domains_verify.`;
+To add a custom domain: domains_validate → domains_set → domains_records (show DNS records to user) → user configures DNS → domains_verify.`;
 export function createServer(ship) {
     const server = new McpServer({
         name: 'shipstatic',
@@ -24,38 +28,37 @@ export function createServer(ship) {
     });
     // Deployments
     server.registerTool('deployments_upload', {
-        description: 'Deploy a static site by uploading files from a directory. Returns the deployment with its live URL, file count, and size.',
+        description: 'Deploy a static site instantly. No account or API key required. Returns the live URL, file count, and size. Without SHIP_API_KEY, the response includes a claim URL (site expires in 3 days) — always show both the deployment URL and claim URL to the user.',
         annotations: CREATE,
         inputSchema: {
             path: z.string().describe('Absolute path to the build output directory to deploy (e.g. "/Users/me/project/dist")'),
-            subdomain: z.string().optional().describe('Preferred subdomain for the deployment URL (e.g. "my-site" for my-site.shipstatic.dev). If unavailable or omitted, a random name is assigned.'),
             labels: z.array(z.string()).optional().describe('Labels for organizing deployments (e.g. ["production", "v1.2"]). Lowercase, 3-25 chars, allows . _ - separators.'),
         },
-    }, ({ path, subdomain, labels }) => call(() => ship.deployments.upload(path, { subdomain, labels, via: 'mcp' })));
+    }, ({ path, labels }) => call(() => ship.deployments.upload(path, { labels, via: 'mcp' })));
     server.registerTool('deployments_list', {
-        description: 'List all deployments with their URLs, status, and labels.',
+        description: 'List all deployments with their hostnames, status, and labels.',
         annotations: READ,
     }, () => call(() => ship.deployments.list()));
     server.registerTool('deployments_get', {
-        description: 'Get deployment details including URL, status, file count, size, and labels.',
+        description: 'Get deployment details including status, file count, size, and labels.',
         annotations: READ,
         inputSchema: {
-            deployment: z.string().describe('Deployment ID (e.g. "happy-cat-abc1234"). Returned by deployments_upload or deployments_list.'),
+            deployment: z.string().describe('Deployment hostname (e.g. "happy-cat-abc1234.shipstatic.com"). Returned by deployments_upload or deployments_list.'),
         },
     }, ({ deployment }) => call(() => ship.deployments.get(deployment)));
     server.registerTool('deployments_set', {
         description: 'Update deployment labels. Replaces all existing labels.',
         annotations: WRITE,
         inputSchema: {
-            deployment: z.string().describe('Deployment ID (e.g. "happy-cat-abc1234"). Use deployments_list to find IDs.'),
+            deployment: z.string().describe('Deployment hostname (e.g. "happy-cat-abc1234.shipstatic.com"). Use deployments_list to find deployments.'),
             labels: z.array(z.string()).describe('Labels to set. Replaces all existing labels. Pass empty array to clear.'),
         },
     }, ({ deployment, labels }) => call(() => ship.deployments.set(deployment, { labels })));
     server.registerTool('deployments_remove', {
-        description: 'Permanently delete a deployment and its files. You MUST confirm with the user before calling this tool, referencing the deployment ID.',
+        description: 'Permanently delete a deployment and its files. You MUST confirm with the user before calling this tool, referencing the deployment.',
         annotations: DESTRUCTIVE,
         inputSchema: {
-            deployment: z.string().describe('Deployment ID to delete (e.g. "happy-cat-abc1234")'),
+            deployment: z.string().describe('Deployment hostname to delete (e.g. "happy-cat-abc1234.shipstatic.com")'),
         },
     }, ({ deployment }) => call(() => ship.deployments.remove(deployment)));
     // Domains
@@ -64,7 +67,7 @@ export function createServer(ship) {
         annotations: WRITE,
         inputSchema: {
             domain: z.string().describe('Domain name (e.g. "www.example.com" or "blog.example.com")'),
-            deployment: z.string().optional().describe('Deployment ID to serve on this domain (e.g. "happy-cat-abc1234"). Omit to reserve the domain without linking.'),
+            deployment: z.string().optional().describe('Deployment to serve on this domain (e.g. "happy-cat-abc1234.shipstatic.com"). Omit to reserve the domain without linking.'),
             labels: z.array(z.string()).optional().describe('Labels for organizing domains (e.g. ["production"]).'),
         },
     }, ({ domain, deployment, labels }) => call(() => ship.domains.set(domain, { deployment, labels })));

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@shipstatic/mcp",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "mcpName": "com.shipstatic/mcp",
-  "description": "MCP server for ShipStatic — deploy and manage static sites from AI agents",
+  "description": "Deploy static sites instantly from AI agents — no account required",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -14,18 +14,21 @@
     "README.md"
   ],
   "keywords": [
+    "ai",
+    "claude",
+    "deploy",
+    "hosting",
+    "llm",
     "mcp",
     "mcp-server",
     "model-context-protocol",
-    "shipstatic",
-    "deploy",
-    "static-hosting",
-    "hosting",
-    "static",
-    "cloud",
     "ship",
-    "ai",
-    "claude"
+    "static-hosting",
+    "static-site",
+    "typescript",
+    "vibe-coding",
+    "web-hosting",
+    "website"
   ],
   "homepage": "https://github.com/shipstatic/mcp",
   "repository": {
@@ -41,13 +44,13 @@
   "author": "ShipStatic",
   "license": "MIT",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.27.0",
-    "@shipstatic/ship": "^0.7.18",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@shipstatic/ship": "^0.8.6",
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@shipstatic/types": "^0.7.1",
-    "@types/node": "^20.0.0",
+    "@shipstatic/types": "^0.8.2",
+    "@types/node": "^20.19.37",
     "husky": "^9.1.7",
     "typescript": "^5.9.3",
     "vitest": "^3.2.4"