Skip to main content
Glama
jieshu666

shippage-mcp

by jieshu666
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

ShipPage — HTML or Markdown in. URL out. Zero config.

npm version License: MIT

ShipPage is a zero-config HTML publishing service for AI agents. Turn any HTML or Markdown into a public URL with a single HTTP POST — no account, no setup, no build step. Purpose-built for Claude Code, Claude Desktop, Cursor, and any HTTP client.

Official Website: shippage.ai · Install: clawhub install shippage or npx shippage-mcp

English | 中文

What is ShipPage?

ShipPage is a zero-config HTML publishing service designed for AI agents. Hand it any HTML or Markdown and get back a public URL — one API call, done. Markdown content is automatically converted to a beautifully styled, mobile-friendly webpage with GitHub-flavored formatting.

One HTTP POST turns any HTML into a public URL — no account, no setup, no build step. When an AI agent calls the publish endpoint for the first time, ShipPage automatically registers the agent, issues an API key, and returns a live URL — all in one request. No human setup required.

ShipPage is built on Cloudflare Workers, R2, and KV for sub-100ms edge performance. It supports password-protected pages, custom URL slugs, full CRUD management, selective search-engine indexing (public: true), skill auto-update, and integrates with the OpenClaw and MCP ecosystems. MIT-licensed.

Related MCP server: ABOVO MCP Server

Quick Start

Option 1: OpenClaw Skill (Claude Code)

clawhub install shippage

Then tell your AI: "Publish this HTML as a webpage" or "Turn this Markdown into a shareable link" — done.

Option 2: MCP Server (Claude Desktop / Cursor)

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "shippage": {
      "command": "npx",
      "args": ["shippage-mcp"]
    }
  }
}

No API key needed. No environment variables. Supports both publish_html and publish_markdown tools.

Option 3: Direct API

Publish HTML:

curl -X POST https://shippage.ai/v1/publish \
  -H "Content-Type: application/json" \
  -d '{
    "html": "<html><body><h1>Hello World!</h1></body></html>",
    "title": "My Page"
  }'

Publish Markdown (converted to a styled webpage automatically):

curl -X POST https://shippage.ai/v1/publish \
  -H "Content-Type: application/json" \
  -d '{
    "html": "<html>...your rendered markdown...</html>",
    "title": "My Doc"
  }'

Response:

{
  "ok": true,
  "url": "https://shippage.ai/p/x7k2m9",
  "slug": "x7k2m9",
  "expires_at": "2026-04-05T14:30:00Z",
  "_registration": {
    "api_key": "sk_...",
    "claim_url": "https://shippage.ai/claim/ABCD-1234"
  }
}

Save the api_key for subsequent requests. The claim_url lets the user manage pages via web UI (optional).

API Reference

Method

Endpoint

Description

Auth

POST

/v1/publish

Publish HTML, returns public URL

Optional (auto-registers if missing)

GET

/v1/pages

List all published pages

Required

PUT

/v1/pages/:slug

Update a page

Required

DELETE

/v1/pages/:slug

Delete a page

Required

GET

/p/:slug

View a published page

None

GET

/v1/skill/version

Check for skill updates

None

GET

/v1/skill/download

Download latest SKILL.md

None

POST /v1/publish Parameters

Parameter

Required

Type

Description

html

Yes

string

The HTML content to publish

title

No

string

Display name for the page

slug

No

string

Custom URL path (e.g., my-page → shippage.ai/p/my-page)

password

No

string

Require a password to view the page

expires_in

No

number

Seconds until expiry (default: 1,209,600 = 14 days)

public

No

boolean

If true, the page is indexable by search engines (index,follow) and included in /sitemap.xml. Default false (noindex).

Features

Feature

ShipPage

PageDrop

Manual Deploy

Zero config

✅

✅

❌

HTML → Webpage

✅

✅

✅

Markdown → Styled Webpage

✅

❌

❌

Agent identity system

✅

❌

❌

Page management (CRUD)

✅

❌

Varies

Password protection

✅

❌

Varies

Custom URL slugs

✅

❌

✅

OpenClaw + MCP ecosystem

✅

❌

❌

Skill auto-update

✅

❌

❌

Auto-expiry & cleanup

✅

✅

❌

How It Works

Agent calls POST /v1/publish with HTML or rendered Markdown
    │
    ├─ First time? → Auto-register: generate agent_id + api_key + claim_code
    │                Return URL + credentials in one response
    │
    ├─ Returning? → Verify API key, check quota
    │
    ▼
Store HTML in R2 → Store metadata in KV → Return public URL

  • Infrastructure: Cloudflare Workers + R2 (storage) + KV (metadata)

  • Response time: <100ms (edge-deployed on 300+ data centers)

  • Daily cleanup: Cron job removes expired pages automatically

Free Tier

Limit

Value

Publishes per month

20

Max page size

500 KB

Page retention

14 days

Password protection

✅ Included

Custom slugs

✅ Included

No credit card required.

FAQ

Q: Do I need to register before using ShipPage? A: No. ShipPage auto-registers your AI agent on the first API call. No signup, no forms, no email verification.

Q: Can I publish Markdown directly? A: Yes. The OpenClaw skill and MCP server both support Markdown natively — your Markdown is converted to a beautifully styled, mobile-friendly webpage automatically.

Q: What happens when my pages expire? A: Free-tier pages expire after 14 days and are automatically cleaned up. You can re-publish at any time. Pro tier (coming soon) offers permanent pages.

Q: Can I use ShipPage without Claude? A: Yes. ShipPage works with any HTTP client. The API is a standard REST endpoint — use it from any AI agent, script, or tool.

Q: How does skill auto-update work? A: The ShipPage skill checks for updates on first use each session. If a new version is available, it downloads and replaces itself automatically. Changes take effect in the next session.

Q: Is ShipPage open source? A: Yes. The source code is available at github.com/jieshu666/ShipPage-Skill under the MIT license.

Tech Stack

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers