warpweb-mcp

Official MCP server for the Warpweb API — research, build, and deploy AI-generated websites from any MCP-compatible client (Claude Desktop, Claude Code, Cline, Cursor, etc.).

You:    "Build a website for Brookside Plumbing in Austin TX, contact owner@brooksideplumbing.com."

Claude: I'll use the warpweb create_site tool.
        [tool call → siteId returned, build started]
        Site queued. Real builds take 3-8 minutes. I'll poll status...
        [tool call → get_site]
        ...complete. Live at https://brookside-plumbing-a1b2c3.warpweb.app

One POST → research → build → deploy. Warpweb pulls Google Places data (hours, photos, reviews, service area), writes vertical-matched copy, generates a design, builds a multi-page site, adds SEO (meta tags, sitemap, Schema.org JSON-LD), and deploys to a free *.warpweb.app subdomain. Best for service-based local businesses (trades, clinics, salons, agencies, restaurants, real estate).

Quickstart

1. Get an API key

Sign up at warpweb.ai, then issue a key at warpweb.ai/app. Keys look like wwk_.... You get 520 free credits on signup — enough for one solid build plus a few revisions, no card required.

2. Add to your MCP client

Claude Desktop — edit claude_desktop_config.json:

{
  "mcpServers": {
    "warpweb": {
      "command": "npx",
      "args": ["-y", "warpweb-mcp"],
      "env": {
        "WARPWEB_API_KEY": "wwk_your_key_here"
      }
    }
  }
}

Claude Code — add via the MCP UI or claude mcp add:

claude mcp add warpweb npx -y warpweb-mcp --env WARPWEB_API_KEY=wwk_your_key_here

Cline / Cursor / others — same shape: command npx, args ["-y", "warpweb-mcp"], env WARPWEB_API_KEY. Any client that speaks MCP stdio works.

3. Restart your client and try a prompt

"Build a website for Acme Plumbing in Austin TX, contact owner@acmeplumbing.com.
Emphasize 24/7 emergency service."

The client picks create_site from the tool list, fires the build, and polls until the deploy URL is live.

Tools exposed

Ten tools, mapping 1:1 onto the Warpweb V1 REST API. Full request/response shapes live in docs.warpweb.ai.

Businesses

• search_businesses — disambiguate a business name against Google Places before building. Call this first whenever the user gives only a name ("Acme Plumbing"); going straight to create_site will silently pick the wrong match for common names. Returns up to 5 candidates with placeId, address, phone, rating — pass the chosen placeId to create_site for an exact match. Free.

Sites

• create_site — kick off an end-to-end build. Returns siteId immediately; real builds take 3–8 minutes. Poll get_site or subscribe to the site.complete lifecycle webhook.
• get_site — fetch one site's current status. Use this to poll a build (every 2–5 seconds) while status is generating.
• list_sites — list every site on the account.
• refresh_site — bump the inactivity timer on a free-subdomain site (auto-pauses after 7 days). Idempotent and free.

Revisions

• create_revision — conversational edit of a deployed site. Send a plain-English prompt; Warpweb routes small surgical edits or full structural changes automatically. Async, returns revisionId.

Domains

• check_domain — check availability + price for a candidate domain. Free, returns a few related suggestions.
• register_domain — buy a domain via Cloudflare Registrar and attach it to a site. Must call check_domain first; the price field must match the cents returned there.
• attach_domain — for customer-owned domains already registered elsewhere. Returns the CNAME target to set at their existing registrar.

Webhooks

• configure_form_webhook — point form submissions on a site at your HTTP(S) endpoint. Each delivery is HMAC-SHA256 sign

... View full README on GitHub