@shipstatic/mcp 2.7.0 → 2.7.1-beta.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +45 -78
- package/dist/vocabulary.d.ts +1 -1
- package/dist/vocabulary.js +1 -1
- package/package.json +2 -3
package/README.md
CHANGED
|
@@ -2,34 +2,31 @@
|
|
|
2
2
|
|
|
3
3
|
**One URL. Your agent ships.**
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
>
|
|
7
|
-
> **This package is the local alternative.** Install it when your agent needs to deploy a folder on your own machine, when you'd rather configure a token once than sign in, or when your client doesn't speak OAuth yet — the same fifteen tools, reached the other way. [Local setup ↓](#local-the-same-tools-from-your-own-machine)
|
|
5
|
+
Deploy static websites, landing pages, and prototypes instantly from AI agents. Ask yours to put your site online and get back a real, shareable link in seconds. Free, no account needed.
|
|
8
6
|
|
|
9
|
-
|
|
7
|
+
## Add it to your agent
|
|
10
8
|
|
|
11
|
-
|
|
12
|
-
[](https://glama.ai/mcp/servers/shipstatic/mcp)
|
|
13
|
-
|
|
14
|
-
## Hosted: start here
|
|
15
|
-
|
|
16
|
-
Drop `https://mcp.shipstatic.com` into any MCP client. No install, no signup, no API key — your agent can publish a website in its next message.
|
|
9
|
+
Drop `https://mcp.shipstatic.com` into any MCP client. No install, no signup, no API key: your agent can publish a website in its next message.
|
|
17
10
|
|
|
18
11
|
```
|
|
19
12
|
https://mcp.shipstatic.com
|
|
20
13
|
```
|
|
21
14
|
|
|
22
|
-
###
|
|
15
|
+
### ChatGPT
|
|
23
16
|
|
|
24
|
-
|
|
25
|
-
claude mcp add --transport http shipstatic https://mcp.shipstatic.com
|
|
26
|
-
```
|
|
17
|
+
Add the [ShipStatic plugin](https://chatgpt.com/plugins/plugin_asdk_app_6a06f62b2f50819181136d58192063d1) from its page in ChatGPT. There is nothing to paste.
|
|
27
18
|
|
|
28
19
|
### Claude Desktop and claude.ai
|
|
29
20
|
|
|
30
21
|
**Settings → Connectors → Add custom connector**, paste `https://mcp.shipstatic.com`, save.
|
|
31
22
|
|
|
32
|
-
###
|
|
23
|
+
### Claude Code
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
claude mcp add --transport http shipstatic https://mcp.shipstatic.com
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
### Cursor, Antigravity, Windsurf, n8n, Zed, and anywhere with `mcp.json`
|
|
33
30
|
|
|
34
31
|
```json
|
|
35
32
|
{
|
|
@@ -43,74 +40,22 @@ claude mcp add --transport http shipstatic https://mcp.shipstatic.com
|
|
|
43
40
|
|
|
44
41
|
### VS Code
|
|
45
42
|
|
|
46
|
-
Install [ShipStatic for VS Code](https://marketplace.visualstudio.com/items?itemName=shipstatic.shipstatic)
|
|
43
|
+
Install [ShipStatic for VS Code](https://marketplace.visualstudio.com/items?itemName=shipstatic.shipstatic). The server is built in, with no config at all.
|
|
47
44
|
|
|
48
|
-
|
|
45
|
+
## Then just ask
|
|
49
46
|
|
|
50
47
|
> "Publish this with ShipStatic."
|
|
51
48
|
|
|
52
49
|
Your agent publishes the files and answers with two links:
|
|
53
50
|
|
|
54
|
-
- **The live site
|
|
55
|
-
- **A claim link
|
|
56
|
-
|
|
57
|
-
Want the site private? Say "publish this with ShipStatic's built-in password protection". Visitors must enter the password before they can see anything, and saying "built-in" keeps your agent from writing a password page of its own.
|
|
58
|
-
|
|
59
|
-
### Then connect, if you want more
|
|
60
|
-
|
|
61
|
-
Everything above works with no account at all. Connect one when your client offers to sign you in, and the same URL answers with the rest: everything you've shipped, your own domains, and sites that stay up permanently. Nothing to install, no key to paste — your client starts the sign-in itself.
|
|
62
|
-
|
|
63
|
-
## Local: the same tools, from your own machine
|
|
64
|
-
|
|
65
|
-
Install this package when your agent needs to deploy **a folder on your own machine** — the hosted endpoint takes files inline, so it has no path to read from — when you'd rather configure a token once than sign in, or when your MCP client doesn't speak OAuth yet.
|
|
66
|
-
|
|
67
|
-
The config asks for one thing: `SHIP_TOKEN`. **Its value is your API key** — one credential, two names. The console mints it as an *API key* (it starts with `ship-`), and the setting that carries it is called the *token*. Get yours free at [my.shipstatic.com/api-key](https://my.shipstatic.com/api-key), paste it where the snippets below show `ship-your-api-key`, and every site you publish lands in your account and never expires, with a rate limit of your own instead of the shared anonymous pools.
|
|
68
|
-
|
|
69
|
-
The key is optional: leave it out and the local server behaves exactly like the hosted endpoint with no account connected — public sites, claim links, live for 3 days.
|
|
70
|
-
|
|
71
|
-
The server runs with `npx`, which ships with [Node.js](https://nodejs.org) (20.19 or newer).
|
|
72
|
-
|
|
73
|
-
### Claude Code
|
|
74
|
-
|
|
75
|
-
```bash
|
|
76
|
-
claude mcp add shipstatic -e SHIP_TOKEN=ship-your-api-key -- npx -y @shipstatic/mcp
|
|
77
|
-
```
|
|
78
|
-
|
|
79
|
-
### Cursor
|
|
80
|
-
|
|
81
|
-
Add to `~/.cursor/mcp.json`:
|
|
82
|
-
|
|
83
|
-
```json
|
|
84
|
-
{
|
|
85
|
-
"mcpServers": {
|
|
86
|
-
"shipstatic": {
|
|
87
|
-
"command": "npx",
|
|
88
|
-
"args": ["-y", "@shipstatic/mcp"],
|
|
89
|
-
"env": { "SHIP_TOKEN": "ship-your-api-key" }
|
|
90
|
-
}
|
|
91
|
-
}
|
|
92
|
-
}
|
|
93
|
-
```
|
|
94
|
-
|
|
95
|
-
### Antigravity
|
|
51
|
+
- **The live site:** a real URL you can share right away.
|
|
52
|
+
- **A claim link:** the site stays live for 3 days, and opening the claim link keeps it for good. A free account is all it takes.
|
|
96
53
|
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
```json
|
|
100
|
-
{
|
|
101
|
-
"mcpServers": {
|
|
102
|
-
"shipstatic": {
|
|
103
|
-
"command": "npx",
|
|
104
|
-
"args": ["-y", "@shipstatic/mcp"],
|
|
105
|
-
"env": { "SHIP_TOKEN": "ship-your-api-key" }
|
|
106
|
-
}
|
|
107
|
-
}
|
|
108
|
-
}
|
|
109
|
-
```
|
|
54
|
+
Want the site private? Say "publish this with ShipStatic's built-in password protection". Visitors have to type the password before they see anything, and saying "built-in" keeps your agent from writing a password page of its own.
|
|
110
55
|
|
|
111
|
-
|
|
56
|
+
## Connect an account for more
|
|
112
57
|
|
|
113
|
-
|
|
58
|
+
Everything above works with no account at all. Connect one when your client offers to sign you in, and the same URL answers with the rest: everything you've published, your own domains, and sites that never expire. There is nothing to install and no key to paste: your client starts the sign-in itself.
|
|
114
59
|
|
|
115
60
|
## Tools
|
|
116
61
|
|
|
@@ -171,9 +116,31 @@ Key the *attempt*, not the try — a run id, a commit sha, or a uuid generated b
|
|
|
171
116
|
|
|
172
117
|
It needs an account — `SHIP_TOKEN` here, a connected account on the hosted endpoint: a deploy with no account already expires on the platform's schedule, so a `ttl` on one is refused rather than ignored. A deployment carrying a `ttl` cannot be linked to any domain: deploy without one when the site needs a domain.
|
|
173
118
|
|
|
174
|
-
##
|
|
119
|
+
## Run it on your own machine
|
|
120
|
+
|
|
121
|
+
This package runs the same fifteen tools, reached the other way: as a local process instead of the hosted URL. Use it when your MCP client doesn't speak OAuth yet, or when you'd rather set a key once than sign in. To publish a folder from your own machine, use the [ShipStatic CLI](https://github.com/shipstatic/ship) instead: it reads the files straight from disk.
|
|
122
|
+
|
|
123
|
+
It needs [Node.js](https://nodejs.org) 20.19 or newer, and takes one setting, `SHIP_TOKEN`, whose value is your API key from [my.shipstatic.com/api-key](https://my.shipstatic.com/api-key). Without it, the local server works like the hosted URL with no account connected.
|
|
124
|
+
|
|
125
|
+
```bash
|
|
126
|
+
claude mcp add shipstatic -e SHIP_TOKEN=ship-your-api-key -- npx -y @shipstatic/mcp
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
Any other client takes the same command and setting in its `mcp.json`:
|
|
130
|
+
|
|
131
|
+
```json
|
|
132
|
+
{
|
|
133
|
+
"mcpServers": {
|
|
134
|
+
"shipstatic": {
|
|
135
|
+
"command": "npx",
|
|
136
|
+
"args": ["-y", "@shipstatic/mcp"],
|
|
137
|
+
"env": { "SHIP_TOKEN": "ship-your-api-key" }
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
```
|
|
175
142
|
|
|
176
|
-
|
|
143
|
+
The [MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=com.shipstatic/mcp) lists ShipStatic as `com.shipstatic/mcp`, with the hosted URL.
|
|
177
144
|
|
|
178
145
|
## Also available
|
|
179
146
|
|
|
@@ -181,10 +148,10 @@ Published to the [MCP Registry](https://registry.modelcontextprotocol.io/v0.1/se
|
|
|
181
148
|
|---------|----------|
|
|
182
149
|
| **[CLI and SDK](https://github.com/shipstatic/ship)** | `npx @shipstatic/ship ./dist` |
|
|
183
150
|
| **[VS Code](https://marketplace.visualstudio.com/items?itemName=shipstatic.shipstatic)** | Search "ShipStatic" in the Marketplace |
|
|
184
|
-
| **[
|
|
151
|
+
| **[Plugin](https://github.com/shipstatic/plugin)** | Install it in Cursor, Claude Code, Codex or Gemini CLI |
|
|
185
152
|
| **[n8n](https://www.npmjs.com/package/n8n-nodes-shipstatic)** | Search "ShipStatic" in n8n's node panel |
|
|
186
153
|
| **[GitHub Action](https://github.com/shipstatic/action)** | `shipstatic/action@v3` |
|
|
187
|
-
| **[Agent Skill](https://www.shipstatic.com/SKILL.md)** |
|
|
154
|
+
| **[Agent Skill](https://www.shipstatic.com/SKILL.md)** | `npx skills add shipstatic/plugin` |
|
|
188
155
|
|
|
189
156
|
## License
|
|
190
157
|
|
package/dist/vocabulary.d.ts
CHANGED
|
@@ -209,7 +209,7 @@ export declare function titled<C extends {
|
|
|
209
209
|
* precisely when someone would otherwise copy them across.
|
|
210
210
|
*/
|
|
211
211
|
export declare const INSTRUCTION_BLOCKS: {
|
|
212
|
-
readonly opening: "ShipStatic deploys static websites instantly. Free, no account
|
|
212
|
+
readonly opening: "ShipStatic deploys static websites instantly. Free, no account needed.";
|
|
213
213
|
/**
|
|
214
214
|
* Publishing first, on every door. The no-account promise holds only if
|
|
215
215
|
* nothing stands between a person and their first link, so the agent
|
package/dist/vocabulary.js
CHANGED
|
@@ -196,7 +196,7 @@ export function titled(config) {
|
|
|
196
196
|
* precisely when someone would otherwise copy them across.
|
|
197
197
|
*/
|
|
198
198
|
export const INSTRUCTION_BLOCKS = {
|
|
199
|
-
opening: 'ShipStatic deploys static websites instantly. Free, no account
|
|
199
|
+
opening: 'ShipStatic deploys static websites instantly. Free, no account needed.',
|
|
200
200
|
/**
|
|
201
201
|
* Publishing first, on every door. The no-account promise holds only if
|
|
202
202
|
* nothing stands between a person and their first link, so the agent
|
package/package.json
CHANGED
|
@@ -1,8 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@shipstatic/mcp",
|
|
3
|
-
"version": "2.7.0",
|
|
4
|
-
"
|
|
5
|
-
"description": "Deploy static websites, landing pages, and prototypes instantly from AI agents. Start with the hosted endpoint at mcp.shipstatic.com (no install, no signup, no API key), or install this package to deploy folders from your own machine. The same fifteen tools either way.",
|
|
3
|
+
"version": "2.7.1-beta.0",
|
|
4
|
+
"description": "Deploy static websites, landing pages, and prototypes instantly from AI agents. Start with the hosted endpoint at mcp.shipstatic.com (no install, no signup, no API key). This package runs the same fifteen tools on your own machine.",
|
|
6
5
|
"type": "module",
|
|
7
6
|
"main": "./dist/index.js",
|
|
8
7
|
"sideEffects": [
|