PageHubApp/mcp

MCP server that lets AI assistants build, theme, and deploy complete websites on PageHub.
Works with Claude Desktop, Cursor, VS Code, and any MCP-compatible client.
Connect
This package isn't published to npm. Connect to the hosted server instead — there's nothing to install:
The first time you connect, your MCP client opens a browser so you can sign in to PageHub (or create an account). After that it stays signed in.
If your client can't do browser sign-in, send an API key as a header instead: Authorization: Bearer ph_.... Create a key at pagehub.dev/dashboard/api-key.
Running it locally (PageHub contributors)
The stdio server in this folder depends on @pagehub/mcp-core through the PageHub monorepo workspace, so it only runs from inside that repo. Run pnpm install from the repo root, then point your client at it:
It calls the same API as /api/mcp. Set PAGEHUB_API_BASE_URL to http://localhost:3000 to use a local dev server. Needs Node.js 18+.
| Variable | Required | Description |
| ---------------------- | -------- | ----------------------------------------------------------------------------------- |
| PAGEHUB_API_KEY | Yes | API key from pagehub.dev/dashboard/api-key |
| PAGEHUB_API_BASE_URL | No | API base URL (default: https://pagehub.dev) |
Settings come only from the env block of your MCP client config. Nothing is written to your project.
Tools
Discovery
| Tool | Description |
| ---------------------- | ---------------------------------------------------------------------------------------- |
| list_blocks | Browse pre-built block templates with visual descriptions and overridable displayNames |
| get_component_schema | CraftJS component types and props reference (Container, Text, Image, Button, Form, etc.) |
| get_style_reference | Palette CSS variables, styleGuide tokens, layout prop keys, responsive patterns |
| list_presets | Curated theme presets by mood (see Theme Presets) |
Site Building
| Tool | Description |
| ------------------ | -------------------------------------------------------------------------------------- |
| set_theme | Configure palette, fonts, spacing, JSON-LD — supports loading a preset as base |
| insert_node | Add a new node to an existing parent (validates image URLs) |
| delete_node | Remove a node and descendants (protects structural nodes) |
| set_integrations | Configure analytics/tracking (GA4, GTM, Search Console, Meta Pixel) — just pass the ID |
| set_redirects | Configure 301/302 redirect rules for SEO (old path → new path) |
| apply_kit_block | Add a library section block by slug to a page/header/footer |
| add_nodes | Merge new nodes into a site efficiently |
Block Library
Use search_blocks + apply_kit_block for block composition. (Advanced block-library mutation tools are available on the full remote API surface.)
Remote API
| Tool | Description |
| ---------------------------------- | --------------------------------------------------------------------------------------------- |
| list_templates / pull_template | Browse and download stock templates from the API |
| list_sites / select_site | List tenant's sites and set active site context |
| delete_site | Delete a site |
| upload_image | Upload to tenant CDN (validates MIME type) |
| patch_site_node | Edit a single node on a live site |
| patch_site_bulk | Apply multiple node patches atomically (race-condition safe — GET/PATCH/PUT in one operation) |
Pages
| Tool | Description |
| ------------- | -------------------------------------------------------------------------------------- |
| list_pages | List all pages in a site with flags (home, 404, hidden) |
| add_page | Create a new page with SEO props and auto-positioning |
| update_page | Update page name, home/404/hidden flags, SEO metadata, per-page head code / body class |