Publish HTML from Windsurf with MCP

The RunThis.page MCP server lets Windsurf publish HTML pages for you in a single step. Ask Cascade to build a page, and it goes live instantly — no copy-pasting, no file downloads, no manual uploads.

MCP (Model Context Protocol) is an open standard that gives AI tools the ability to call external services. The RunThis.page MCP server exposes five tools that let Windsurf create, update, list, delete, and get analytics for your hosted HTML pages.

Step-by-step: Set up MCP for Windsurf

1. 1

   Get a Pro or Business plan

   The MCP server uses API keys, which require a Pro ($30/mo) or Business ($50/mo) plan. Sign up if you haven't already.

2. 2

   Generate an API key

   Go to Settings in your dashboard and create an API key. Copy it immediately — it's only shown once. It starts with rtp_.

3. 3

   Edit the Windsurf MCP config

   Open (or create) your Windsurf MCP config file and add the RunThis.page server:

   macOS/Linux: ~/.codeium/windsurf/mcp_config.json

   Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

   {
     "mcpServers": {
       "runthispage": {
         "command": "npx",
         "args": ["@runthispage/mcp-server"],
         "env": {
           "RUNTHISPAGE_API_KEY": "rtp_your_key_here"
         }
       }
     }
   }

4. 4

   Restart Windsurf

   Quit and reopen Windsurf for the new MCP server to load. The first run downloads the package automatically via npx.

What you can ask Cascade to do

Once the MCP server is connected, Windsurf's Cascade agent can use five tools to manage your pages:

• publish_page — "Build a landing page for my project and publish it"
• update_page — "Update page a1b2c3d4e5 with a new hero section"
• list_pages — "Show me all my published pages"
• delete_page — "Delete page a1b2c3d4e5"
• get_page_analytics — "How many views has my dashboard page gotten?"

Example prompts to try

Why MCP instead of manual upload?

• ✓ Zero friction — Cascade builds and publishes in a single conversation. No file downloads, no browser tabs.
• ✓ Iterate fast — ask Cascade to tweak the page and republish. The URL stays the same.
• ✓ Structured errors — if something goes wrong (plan limits, auth issues), Cascade gets a machine-readable error with recovery instructions.
• ✓ No extra tools — npx downloads and runs the server automatically. Nothing to install globally.

The MCP server also works with Claude Desktop, Claude Code, Cursor, and VS Code with GitHub Copilot. For programmatic publishing from scripts or CI/CD, see the REST API guide.