{
  "markdown": "# warpweb-mcp\n\nOfficial MCP server for the [Warpweb API](https://warpweb.ai) — research, build, and deploy AI-generated websites from any MCP-compatible client (Claude Desktop, Claude Code, Cline, Cursor, etc.).\n\n```\nYou:    \"Build a website for Brookside Plumbing in Austin TX, contact owner@brooksideplumbing.com.\"\n\nClaude: I'll use the warpweb create_site tool.\n        [tool call → siteId returned, build started]\n        Site queued. Real builds take 3-8 minutes. I'll poll status...\n        [tool call → get_site]\n        ...complete. Live at https://brookside-plumbing-a1b2c3.warpweb.app\n```\n\nOne 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).\n\n---\n\n## Quickstart\n\n### 1. Get an API key\n\nSign up at [warpweb.ai](https://warpweb.ai), then issue a key at [warpweb.ai/app](https://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.\n\n### 2. Add to your MCP client\n\n**Claude Desktop** — edit `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"warpweb\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"warpweb-mcp\"],\n      \"env\": {\n        \"WARPWEB_API_KEY\": \"wwk_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n**Claude Code** — add via the MCP UI or `claude mcp add`:\n\n```bash\nclaude mcp add warpweb npx -y warpweb-mcp --env WARPWEB_API_KEY=wwk_your_key_here\n```\n\n**Cline / Cursor / others** — same shape: command `npx`, args `[\"-y\", \"warpweb-mcp\"]`, env `WARPWEB_API_KEY`. Any client that speaks MCP stdio works.\n\n### 3. Restart your client and try a prompt\n\n```\n\"Build a website for Acme Plumbing in Austin TX, contact owner@acmeplumbing.com.\nEmphasize 24/7 emergency service.\"\n```\n\nThe client picks `create_site` from the tool list, fires the build, and polls until the deploy URL is live.\n\n---\n\n## Tools exposed\n\nTen tools, mapping 1:1 onto the Warpweb V1 REST API. Full request/response shapes live in [docs.warpweb.ai](https://docs.warpweb.ai).\n\n### Businesses\n- **`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.\n\n### Sites\n- **`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.\n- **`get_site`** — fetch one site's current status. Use this to poll a build (every 2–5 seconds) while `status` is `generating`.\n- **`list_sites`** — list every site on the account.\n- **`refresh_site`** — bump the inactivity timer on a free-subdomain site (auto-pauses after 7 days). Idempotent and free.\n\n### Revisions\n- **`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`.\n\n### Domains\n- **`check_domain`** — check availability + price for a candidate domain. Free, returns a few related suggestions.\n- **`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.\n- **`attach_domain`** — for customer-owned domains already registered elsewhere. Returns the CNAME target to set at their existing registrar.\n\n### Webhooks\n- **`configure_form_webhook`** — point form submissions on a site at your HTTP(S) endpoint. Each delivery is HMAC-SHA256 signed; the signing secret is returned **once** on first configure or rotate — capture it immediately.\n\nThe LLM gets the full input schema (required/optional fields, types, descriptions) at runtime via MCP — no need to memorize parameters.\n\n---\n\n## Example prompts\n\n- *\"Build a website for [Business Name] in [City, State], owner email [email].\"*\n- *\"Check if `<domain>` is available and what it would cost.\"*\n- *\"On site `<siteId>`, change the headline to mention free estimates and add an FAQ about emergency service.\"*\n- *\"Attach the domain `acmeplumbing.com` to site `<siteId>` — the customer already owns it at GoDaddy.\"*\n- *\"Configure form submissions on site `<siteId>` to POST to `https://my-crm.example.com/leads`.\"*\n\n---\n\n## Pricing\n\n- **520 credits free on signup** (with email verification).\n- **Credit packs**, one-time Stripe Checkout:\n  - Starter — $5 for 100 credits\n  - Builder — $25 for 600 credits (16% bulk discount)\n  - Pro — $100 for 2,800 credits (29% bulk discount)\n- **Active Site subscription** — $10/site/month, only on sites with a custom domain attached. Free-subdomain sites have no monthly cost.\n\nPer-call directional credit costs:\n\n| Tool | Cost |\n|---|---|\n| `create_site` | ~200–500 credits (billed at end-of-build against actual AI usage) |\n| `create_revision` | ~20–100 credits |\n| `attach_domain` | 5 credits |\n| `register_domain` | 50 credits + registrar pass-through |\n| `search_businesses`, `check_domain`, `get_site`, `list_sites`, `refresh_site`, `configure_form_webhook` | Free |\n\n---\n\n## Troubleshooting\n\n**`Check WARPWEB_API_KEY env var` (401)**\nThe key in your client config is missing, malformed, or revoked. Issue a fresh one at [warpweb.ai/app](https://warpweb.ai/app). Keys start with `wwk_`.\n\n**`Add credits at warpweb.ai/app/credits` (402)**\nAccount balance is 0 and auto-refill is off. Add credits or enable auto-refill on the dashboard.\n\n**`Daily quota exceeded` (429)**\nPer-day site / revision / domain limits exist to protect against runaway loops. The error message includes the quota object with `used`, `limit`, and `resetDescription`.\n\n**`queue_full: true` (429 on revisions)**\nEach site has a revision queue depth of 3 (1 running + 2 waiting). Wait for the current revision to land before queueing more.\n\n**Tool list is empty when client connects**\n`WARPWEB_API_KEY` isn't set in the client config's `env` block. The server starts in NO-TOOL mode so the connection still completes — set the env var and restart your client.\n\n**Want to test against staging?**\nSet `WARPWEB_API_URL` to point at a different base URL (default is `https://api.warpweb.ai/v1`).\n\n---\n\n## When NOT to use Warpweb\n\n- Your business doesn't have a Google Places listing. Warpweb works, but the result reads more generic — research falls back to your `businessDescription`. Calibrated for service-based local businesses (trades, clinics, salons, agencies, restaurants, real estate).\n- You want hand-coded templates with pixel-perfect control. Warpweb generates layouts; it doesn't take a Figma spec as input. Use Next.js / Astro yourself for that.\n- You need a drag-and-drop builder UI. Warpweb is API-only.\n- Static personal sites that never change. Cloudflare Pages alone is cheaper.\n\n---\n\n## Links\n\n- API reference: [docs.warpweb.ai](https://docs.warpweb.ai)\n- Marketing + signup: [warpweb.ai](https://warpweb.ai)\n- API key management: [warpweb.ai/app](https://warpweb.ai/app)\n- Repo: [github.com/northbeamsoftware/warpweb-mcp](https://github.com/northbeamsoftware/warpweb-mcp)\n- Machine-readable reference (for LLM agents): [warpweb.ai/llms-full.txt](https://warpweb.ai/llms-full.txt)\n\n## License\n\nMIT — see [LICENSE](./LICENSE).\n\n## Contributing\n\nIssues + PRs welcome at [github.com/northbeamsoftware/warpweb-mcp](https://github.com/northbeamsoftware/warpweb-mcp). New tools should map 1:1 onto public V1 endpoints; don't surface internal Warpweb concepts.\n",
  "bytes": 7891,
  "sha": "35b16c418c946c450f780c9b9df452eea8c65398bcf70d406cda30759b1ec546",
  "repo_slug": "northbeamsoftware/warpweb-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_northbeamsoftware_warpweb_52f2f730/readme"
}