htmltolink-mcp

Deploy any HTML project to a live public URL in seconds — directly from Cursor, Claude Code, or any MCP-compatible AI agent.

No server. No config. No build pipeline. Just one command and you get a shareable link.

Quick Start

Cursor

Add to .cursor/mcp.json:

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

Then just tell Cursor: "Deploy this project" — it will package your files, upload them, and return a live URL.

Claude Code

Add to .mcp.json in your project root:

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

Claude Desktop

Add to claude_desktop_config.json:

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

Available Tools

Tool	Description
deploy	Package and deploy a project directory to htmlto.link
status	Check existing deployment info from .htmltolink.json

Authentication (Optional)

By default, deployments are anonymous and temporary (24 hours). The agent automatically saves update credentials so it can refresh the same link.

For persistent managed pages, set your API token:

{
  "mcpServers": {
    "htmltolink": {
      "command": "npx",
      "args": ["-y", "htmltolink-mcp"],
      "env": {
        "HTML_TO_LINK_TOKEN": "your-api-token"
      }
    }
  }
}

Get your token from htmlto.link/settings.

How It Works

1. Agent calls the deploy tool with your project directory
2. MCP server zips the project (excluding node_modules, .git, secrets, etc.)
3. Uploads to https://htmlto.link/api/skill/deploy
4. Saves deployment info to .htmltolink.json (auto-added to .gitignore)
5. Returns the live public URL

Use Cases

• 🚀 AI-generated pages: Cursor/Claude builds a landing page → instant live URL
• 📋 Client demos: Share a prototype link in seconds
• 🧪 Quick previews: Test responsive design on real devices
• 📦 Portfolio pieces: Host experiments without setting up hosting

Using .cursorrules (Alternative)

If you prefer prompt-based integration over MCP, copy the .cursorrules file from this repo into your project root. The agent will follow the instructions to deploy via the HTTP API directly.

Links

• Website: https://htmlto.link
• Skill Guide: https://htmlto.link/skill
• API Docs: POST https://htmlto.link/api/skill/deploy

License

MIT