Phase 3

MCP + Skill Bridge

Claude Code IS the daily workflow. /publish = muscle memory. MCP makes NowPage programmable.

First Principle: Claude Code IS the daily workflow. /publish becomes muscle memory. MCP makes NowPage programmable by any LLM tool. Too many tools = cognitive overhead. Ship essentials only.

Second-Order Effects

Workflow Speed: /publish compiles, publishes, and opens the URL in one command. No context switching.
Programmable Platform: MCP tools let any AI tool (Claude, Cursor, Copilot) manage NowPage programmatically.
Pipeline Automation: Transcript → generate → publish can become a single MCP call chain.
Vault Integration: MCP reads vault secrets with proper scoping. Write access through UI only.

Existing MCP Tools (v1)

publish_page

Publish HTML to a domain with slug, folder, and tags

list_domains

List all domains accessible to the API key

list_templates

List available Reveal templates

get_page_html

Retrieve raw HTML content of a published page

New MCP Tools (v2)

list_pages

Filtered page list by domain, folder, or tag

delete_page

Delete a page with confirmation prompt

move_page

Transfer a page between domains

create_domain

Create subdomain + Vercel provision

delete_domain

Delete domain with page count warning

repair_domains

Bulk Vercel provisioning for broken domains

vault_list

List secret names + categories (no values)

vault_get

Decrypt and return a secret (scoped to API key owner)

get_analytics

Page views, leads, top pages by domain

Atomic Parts

3.1

Claude Code Skill: /publish

Wraps hc-publish.js with smart defaults. Auto-detects domain and slug from file metadata. Runs compile-jsx.js for JSX sources. Shows live URL after publish. Muscle memory for daily workflow.

# Usage in Claude Code
/publish rich-meekins-v3.html

# Auto-detects:
# - Domain from hc-metadata or defaults to ideas.asapai.net
# - Slug from filename or hc-metadata
# - Compiles JSX if needed
# - Opens URL after publish

3.2

MCP: Page Management Tools

list_pages(domain, folder, tag), delete_page(page_id or slug+domain), move_page(page_id, target_domain_id). All scoped by API key permissions.

3.3

MCP: Domain Management Tools

create_domain(subdomain, root_domain), delete_domain(domain_id), repair_domains(). Create includes Vercel provisioning. Delete warns about page count.

3.4

MCP: Vault Read Access

vault_list() and vault_get(key). Scoped by API key's user. Write access through UI only for security.

3.5

MCP: Analytics

get_analytics(domain, date_range). Returns page views, leads captured, top pages.

3.6

MCP Auth Upgrade

API key carries full user context. Vault access scoped to API key owner's secrets. Domain operations scoped to API key's domain_ids.

Key Files

File	Role
mcp-nowpage/server.py	MCP server — add new tools
lib/auth/api-key.ts	API key validation + user context
scripts/hc-publish.js	Publish script wrapped by /publish skill
compile-jsx.js	JSX compiler called by /publish

Risk to Mitigate: Too many tools = cognitive overhead. Ship the 9 essential tools (v2 list above). No workflow automation, no batch operations, no template management via MCP. Those come later if needed.

Verification

/publish skill works in Claude Code — compiles, publishes, opens URL
MCP list_pages / move_page / delete_page work from Claude Code
MCP vault_list shows secrets, vault_get returns values
API key scoping is enforced — can't access other users' vault or domains