Shippage MCP Server

MCP server for publishing AI-generated HTML, Markdown, text, static folders, and assets to Shippage.

This repo is the MCP-focused entry point for Shippage. The implementation is intentionally thin and runs the MCP server bundled with the Shippage CLI package.

Install

npm i -g @vantienkhai/shippage-cli

Authenticate

Run browser login once:

shippage login

The CLI saves a long-lived Shippage API key locally. For CI or hosted agents, pass credentials with environment variables:

export SHIPPAGE_API_URL="https://shippage.app"
export SHIPPAGE_TOKEN="<your spg_ API key>"

MCP Configuration

Use this with Claude Code, Cursor, Windsurf, Codex, or any MCP-compatible agent:

{
  "mcpServers": {
    "shippage": {
      "command": "shippage",
      "args": ["mcp"],
      "env": {
        "SHIPPAGE_API_URL": "https://shippage.app"
      }
    }
  }
}

If your agent prefers a dedicated command, this wrapper package also provides:

shippage-mcp

Equivalent MCP config:

{
  "mcpServers": {
    "shippage": {
      "command": "shippage-mcp",
      "env": {
        "SHIPPAGE_API_URL": "https://shippage.app"
      }
    }
  }
}

Tools

• publish_page — publish HTML, Markdown, text, ZIP files, or static folders with index.html.
• upload_asset — upload images, video, fonts, scripts, stylesheets, or binary assets and return public URLs.
• list_pages — list pages owned by the configured Shippage token.
• update_page — change visibility, private token, slug, or custom domain.
• delete_page — delete an owned page.

Example Agent Request

{
  "tool": "publish_page",
  "arguments": {
    "targetPath": "./dist",
    "title": "Launch Notes",
    "slug": "launch-notes",
    "visibility": "public",
    "uploadAssets": true
  }
}

Expected result:

{
  "shareUrl": "https://shippage.app/launch-notes",
  "title": "Launch Notes"
}

Related

• Main website: https://shippage.app
• Web app repo: https://github.com/Kaka-123-D/shippage
• CLI repo: https://github.com/Kaka-123-D/shippage-cli
• npm package: https://www.npmjs.com/package/@vantienkhai/shippage-cli