# shipstatic/mcp [Health: Active]

**Category:** ☁️ Cloud Platforms  
**Repository:** https://github.com/shipstatic/mcp  
**GitHub Stars:** 7  
**npm Downloads (last month):** 7007  
**Views:** 16  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/shipstatic-mcp

## Description
Deploy and manage static sites from AI agents. A simpler alternative to Vercel and Netlify for static website hosting — upload files, get a URL, and connect custom domains.

## Tools
Capabilities this server exposes over MCP:

- **deployments_upload** — Deploy a static site instantly: free, no account or API key required. Returns the live URL, file count, and size. Without SHIP_TOKEN, the response also includes a one-time claim URL, and the site expires in 3 days unless claimed. Pass `password` to make the site private.
- **deployments_list** — List all deployments with their URLs, status, labels, and password protection state. The response's `cursor` is null on the last page; pass it back as `cursor` to fetch the next.
- **deployments_get** — Get deployment details including URL, status, file count, size, labels, and password protection state.
- **deployments_set** — Update deployment labels. Replaces all existing labels.
- **deployments_delete** — Permanently deletes a deployment and its files.
- **domains_set** — Create or update a domain: a ShipStatic domain (e.g. "yourname.shipstatic.com"), live as soon as a deployment is linked, or a custom domain (e.g. "www.example.com"), which needs DNS records first. Can reserve a name (omit deployment), link it to a deployment, switch deployments, or update labels. For a custom domain, domains_records then returns the DNS records to configure.
- **domains_list** — List all domains with their URLs, linked deployment, and `status`. The response's `cursor` is null on the last page; pass it back as `cursor` to fetch the next.
- **domains_get** — Get domain details including URL, linked deployment, labels, and `status`: the one word saying what the domain needs from its owner (`unverified`, `unlinked`, `live`, `paused`).
- **domains_records** — Returns the DNS records to configure at the domain's DNS provider. Call after domains_set. Custom domains only: a ShipStatic domain has no records to configure.
- **domains_dns** — Returns the DNS provider recorded for the domain, if known (e.g. Cloudflare, Namecheap): where its DNS records are configured. Custom domains only, and only while the domain is unverified; once its DNS is right there is nothing left to locate.
- **domains_share** — Returns a shareable DNS setup URL that needs no API key, for whoever manages the domain's DNS. Custom domains only, and only while the domain is unverified; a verified domain has no setup left to share.
- **domains_validate** — Check if a domain name is valid and available before creating it. Returns the normalized form and availability.
- **domains_verify** — Trigger DNS verification for a custom domain. Call after the user has configured DNS records from domains_records. Custom domains only, and refused once the domain is verified: read domains_get instead. Verification is asynchronous: read the domain again with domains_get to learn the verdict, since its `status` has not moved yet when this returns. A verified domain serves nothing until a deployment is linked with domains_set.
- **domains_delete** — Permanently deletes a domain.
- **whoami** — Returns your email and name, and the account's plan, usage and caps.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "mcp": {
    "command": "npx",
    "args": ["-y","@shipstatic/mcp"],
    "env": {
      "SHIP_TOKEN": ""
    }
  }
}
```

**Requires environment variables:** `SHIP_TOKEN` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What shipstatic/mcp MCP server does

shipstatic/mcp exposes ShipStatic's static hosting workflow through MCP. Agents can upload a folder of site files and receive a live URL, file count, and total size. Anonymous uploads can also return a one-time claim URL; unclaimed sites expire after three days. Uploads may include password protection.

With an account connected, the toolset also covers deployment and domain administration. Agents can list, inspect, label, and permanently delete deployments, then create or update custom-domain associations. Domain tools report verification state, provide DNS records, identify a recorded DNS provider, generate a shareable DNS setup link, validate availability, trigger verification, and remove domains. `whoami` reports the account identity, plan, usage, and caps.

## How it works

The hosted MCP endpoint is available at `https://mcp.shipstatic.com`. An MCP client connects to that URL and can invoke the same fifteen tools without installing the package. Anonymous access is centered on `deployments_upload`; the remaining account-oriented tools respond after a hosted account sign-in or when a token is configured locally.

The local package runs as an MCP process and reaches the same tool set through stdio. It is useful for clients that do not support the hosted sign-in flow or for setups that prefer a token in client configuration. It does not read a local folder for upload automatically; the ShipStatic CLI is the separate surface for publishing files directly from disk.

Deployment and domain lists support `limit` and `cursor`. Pass the returned cursor to request the next page; a null cursor marks the final page. Uploads can use an idempotency key for account-based retries, so a timed-out request can be safely repeated without creating a duplicate deployment. The same key must identify the overall attempt and is ignored for anonymous uploads.

## Setup and configuration

For the hosted service, add `https://mcp.shipstatic.com` as a custom MCP connector or server URL. Claude Desktop and claude.ai use the custom connector settings; Claude Code can be configured with its HTTP transport; clients using `mcp.json` can define the URL directly.

For local use, install and launch the package with `npx -y @shipstatic/mcp`. Node.js 20.19 or newer is required. Set `SHIP_TOKEN` to an API key from ShipStatic when account-backed local access is needed:

```json
{
  "mcpServers": {
    "shipstatic": {
      "command": "npx",
      "args": ["-y", "@shipstatic/mcp"],
      "env": { "SHIP_TOKEN": "ship-your-api-key" }
    }
  }
}
```

The hosted endpoint can also be used without an account. A connected account keeps sites permanently and enables custom domains; anonymous sites follow the platform's expiration behavior until claimed.

## Tools and capabilities

- Upload static files, optionally with a password, time-to-live, and idempotency key.
- List, inspect, label, and delete deployments.
- Create, link, relink, label, verify, and delete custom domains.
- Retrieve DNS records, DNS-provider information, and shareable DNS setup links.
- Validate domain names and check asynchronous verification results.
- Inspect account identity, plan, usage, and limits.
- Page through deployment and domain lists with cursors.

## Limitations and notes

A deployment with a `ttl` requires an account and cannot be linked to a domain. Anonymous deployments already use the platform's expiration schedule, so a TTL is refused for them. A verified domain serves no site until it is linked to a deployment. DNS verification is asynchronous: call `domains_get` after `domains_verify` to read the result.

`domains_records`, `domains_dns`, and `domains_share` apply to custom domains while they are unverified. ShipStatic domains do not require DNS records. Deleting a deployment permanently removes its files, and deleting a domain permanently disconnects it.

_Full upstream README: https://allmcps.com/mcp/shipstatic-mcp/readme_

