@sellhapi/mcp

MCP server for SellHapi — build and manage storefronts from AI tools.

Two modes

Stdio (Claude Code, Cursor, Windsurf) — runs locally, authenticates with API key.

Hosted HTTP (ChatGPT, Claude web) — runs as a service, authenticates via OAuth 2.1.

Setup — stdio

1. Install

npm install -g @sellhapi/mcp

2. Get an API key

Go to sellhapi.com → Settings → API Keys → Create Key.

3. Configure your AI tool

Claude Code — add to ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "sellhapi": {
      "command": "sellhapi-mcp",
      "args": ["--api-key", "sk_live_your_key_here"]
    }
  }
}

Cursor — add to MCP settings:

{
  "mcpServers": {
    "sellhapi": {
      "command": "npx",
      "args": ["-y", "@sellhapi/mcp@latest", "--api-key", "sk_live_your_key_here"]
    }
  }
}

Or set the environment variable instead of --api-key:

export SELLHAPI_API_KEY=sk_live_your_key_here

Setup — hosted (ChatGPT, Claude web)

The SellHapi MCP server is hosted at:

https://sellhapi-mcp.onrender.com/mcp

No installation required — just connect your AI client.

Claude web

1. Go to claude.ai → Settings → Integrations → Add integration
2. Enter: https://sellhapi-mcp.onrender.com/mcp
3. Click Connect — you'll be redirected to SellHapi to authorise access
4. Once authorised, all SellHapi tools are available in your Claude conversations

ChatGPT

1. Go to chatgpt.com → your profile → My GPTs → Create a GPT (or edit an existing one)
2. In the GPT editor → Configure → Actions → Add action
3. Set the server URL to: https://sellhapi-mcp.onrender.com/mcp
4. Authentication: OAuth 2.0 — the server handles the full flow automatically

sell_api env vars

The sell_api server needs these for OAuth:

| Variable | Description | |----------|-------------| | MCP_OAUTH_SECRET | JWT signing secret for MCP access tokens. Falls back to JWT_VENDOR_SECRET if not set. | | SELLHAPI_VENDOR_URL | Base URL for consent pages (default: https://sellhapi.com) |

Tools

Studio (15)

• list_projects — list vendor's Studio projects
• get_project — get project details with code
• create_project — create a new project (returns workflow guide + build rules)
• apply_design_direction — store a full DesignDirection (colors, fonts, pages) — zero credits
• set_design_direction — ask SellHapi's Claude to generate a direction from a brief (costs credits)
• analyze_design_reference — extract design DNA from an image, website URL, or Pinterest pins
• import_website_content — scrape existing website copy into the project
• analyze_reference — fetch OG metadata + theme color from any URL
• apply_wireframe — store approved mid-fidelity wireframes per page — zero credits
• push_code — push React code (validated by BuildGuard) — zero credits
• patch_code — push only changed files, merged into existing code — zero credits
• deploy_website — publish project to live storefront
• get_preview — get current sandbox preview URL
• list_revisions — list revision history
• get_revision — get a specific revision's code
• restore_revision — restore project to a previous revision

Context

• get_vendor_context — call this first — returns capabilities, store slug, product/service counts in one call
• suggest_capabilities — given a business brief, returns ranked capability IDs to activate

Commerce (8)

• list_products, list_digital_products, list_service_listings
• list_events, list_membership_tiers, list_donation_campaigns
• list_appointment_services, list_capabilities

Content (4)

• list_content, list_forms, list_collections, list_articles

Intelligence (2)

• list_orders, get_wallet_balance

Reference

• get_build_rules — full BuildGuard validation rules (call when push_code fails)
• get_runtime_hooks — complete @sellhapi/studio-runtime hook reference

Resources

• sellhapi://runtime-hooks — available React hooks from @sellhapi/studio-runtime
• sellhapi://build-rules — BuildGuard validation rules
• sellhapi://capability-patterns — UX patterns per capability

Auth

API key (sk_live_...) — for stdio clients. Create at sellhapi.com → Settings → API Keys.

OAuth 2.1 — for web clients. The hosted server proxies OAuth to sell_api. Supports dynamic client registration (RFC 7591) and PKCE (S256).

Development

npm run dev    # watch mode (tsc --watch)
npm run build  # compile
npm start      # stdio mode
npm run start:hosted  # hosted HTTP mode