Model Context Protocol (MCP)npm v1.5.4

Build full websites
from your AI tool

The Social AI MCP server connects Claude, Codex, Antigravity, Windsurf, Perplexity, VS Code Copilot and Cursor to the website builder — so your AI can create, edit, stock and publish complete websites and online stores directly from chat.

https://socialai.one/api/mcp

Hosted OAuth · No JSON, npm install, or API key needed for Claude and Cowork

Repository MCP v1.6.0 is pending release; npm latest remains v1.5.4.

The setup button copies Social AI's reviewed OpenAI endpoint and opens ChatGPT Plugins. Existing SocialAI entitlements apply; purchases remain on SocialAI.one. Turn on Developer mode, press +, paste the URL, then complete Social AI OAuth. ChatGPT does not currently provide a supported link that can create an unpublished custom app automatically. Accounting records returned by the connector include direct Social AI verification links.

Connect another AI client

Cursor supports a true install deep link. Other clients copy the endpoint and open their supported setup surface. MCP 1.5.5 accounting results include direct Social AI verification links.

How it works — 3 steps

1

Sign up free

Create your Social AI account — no credit card needed. Your 30-day full-access trial starts immediately.

2

Connect the MCP

Claude, Cowork, and other remote clients use the OAuth connector. Local CLI and IDE clients use the npm configuration and an API key.

3

Tell your AI what to build

"Build me a fashion store for Cape Town with Paystack." The AI handles templates, products, theme, and publishing.

🎁

30-day free trial — full write access

New accounts get full MCP write access for 30 days. Create websites, add products, configure payments, and publish live — no credit card, no upgrade required. After 30 days: upgrade to Pro to keep building via MCP, or use the visual editor on our Free plan. MCP 1.5.5 also returns direct verification links for accounting books, contacts, invoices, bills and supplier-payment records.

Start your free trial

Connect via OAuth — no API key needed

Claude.ai, Claude Desktop, Cowork, and other OAuth-capable clients can connect directly to Social AI using one-click authorisation — no JSON config, no API key copy-paste.

🌐Claude.ai (web)
  1. 1Go to Customize → Connectors → + Add custom connector
  2. 2Paste: https://socialai.one/api/mcp
  3. 3Click Connect — you'll be redirected to log in and approve access
  4. 4Start a new chat and enable Social AI from + → Connectors
🖥️Claude Desktop / Cowork
  1. 1Open Claude Desktop → Customize → Connectors
  2. 2Click + → Add custom connector
  3. 3Paste: https://socialai.one/api/mcp
  4. 4Approve the OAuth login, then enable Social AI for the conversation from + → Connectors — no JSON or npm needed
⚡ChatGPT
  1. 1Open chatgpt.com/plugins and enable Developer mode in ChatGPT settings
  2. 2Press + to create a developer-mode app
  3. 3Name it Social AI, paste https://socialai.one/api/mcp/openai, and choose Create
  4. 4Complete Social AI OAuth, start a new chat, select Social AI from + → More, and ask: "List my Social AI websites"
🔌Antigravity
  1. 1Open MCP Servers → Manage MCP Servers → View raw config
  2. 2Add https://socialai.one/api/mcp as the serverUrl, then save
  3. 3Select Authenticate and complete the Social AI sign-in in that browser window
  4. 4The tools reconnect automatically when authorisation finishes
🔎Perplexity
  1. 1Open Perplexity Settings → Connectors / MCP (where available)
  2. 2Add: https://socialai.one/api/mcp
  3. 3Complete the Social AI sign-in when prompted
  4. 4Ask: "List my Social AI websites" to verify; remote MCP access can vary by plan and rollout

💡 Can't get OAuth to work? Try these

No OAuth window appeared

Remove the connector, add https://socialai.one/api/mcp again, and choose Connect. Do not switch to JSON setup in Cowork.

Login worked but tools are missing

Start a new conversation, open + → Connectors, enable Social AI, and ask the AI to call get_started. A connector is only verified when a tool is callable.

Using a local CLI or IDE

Use the npm configuration below with a user API key. Keep the real key in the local config or secret store; do not paste or repeat it in chat.

Consent or redirect error

Remove and re-add the connector, then retry in a fresh browser tab. If it still fails, report the client name and exact error without including tokens or passwords.

Local API key setup

For stdio-based tools (Claude Code, Cursor, Windsurf, VS Code Copilot) — use the same npm package and the config file shown for your tool. Keep the real key in that local file or a secret store; use the placeholder when asking an AI for setup help.

Claude Code~/.claude/settings.json
{
  "mcpServers": {
    "socialai-websites": {
      "command": "npx",
      "args": ["-y", "@socialai/website-mcp"],
      "env": { "SOCIALAI_API_KEY": "sai_user_xxxxxxxx" }
    }
  }
}
VS Code Copilot.vscode/settings.json
{
  "mcp": {
    "servers": {
      "socialai-websites": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "@socialai/website-mcp"],
        "env": { "SOCIALAI_API_KEY": "sai_user_xxxxxxxx" }
      }
    }
  }
}
Cursor.cursor/mcp.json
{
  "mcpServers": {
    "socialai-websites": {
      "command": "npx",
      "args": ["-y", "@socialai/website-mcp"],
      "env": { "SOCIALAI_API_KEY": "sai_user_xxxxxxxx" }
    }
  }
}
WindsurfWindsurf Settings → MCP
{
  "mcpServers": {
    "socialai-websites": {
      "command": "npx",
      "args": ["-y", "@socialai/website-mcp"],
      "env": { "SOCIALAI_API_KEY": "sai_user_xxxxxxxx" }
    }
  }
}
OpenAI Codex~/.codex/config.toml
[mcp_servers.socialai_websites]
command = "npx"
args = ["-y", "@socialai/website-mcp"]

[mcp_servers.socialai_websites.env]
SOCIALAI_API_KEY = "sai_user_xxxxxxxx"

Replace sai_user_xxxxxxxx with your API key from Settings → API Keys.

Ask your AI to install it for you

Choose your tool above and send its configuration with the placeholder still present. Enter the real key only in the local config or secret prompt:

Install the Social AI MCP for me. Save this configuration to the correct MCP config file for this tool, keeping my other MCP servers unchanged. Leave SOCIALAI_API_KEY as a placeholder and tell me where to enter it locally without posting it in chat. Restart or reconnect the MCP, call get_started, then list my Social AI websites to verify that a tool is actually callable.

See every change in a normal browser tab

After Social AI creates or edits a website, it returns a draft preview link. Open it in your preferred external browser once (or copy the link there if your AI opens an unreliable built-in browser), then refresh that same tab after each change. The draft link is safe to use before publishing; the published link is only for the live site.

1. Ask for the link

Say: “After every change, call get_preview_url and show me a clickable preview link.”

2. Keep it open

Open the draft preview in your default browser. Your AI client does not need to control that tab.

3. Refresh and approve

Refresh after each edit, then tell the AI what to change next or ask it to publish.

What you can ask

Just describe what you need — your AI figures out which tools to call. For a reviewable workflow, add: “Show me the draft preview link after each change; do not publish until I approve.”

🇺🇸

"Build me a fashion store for New York, set up Stripe, and publish it"

→ Sets country=US, currency=USD → configures Stripe → publishes live

🌍

"List your shop templates, then build me a coffee brand store from the best match"

→ Browses templates → forks the right one → seeds products → sets theme

🇿🇦

"Set this store up for South Africa with Paystack and import 10 products from this CSV"

→ Sets country=ZA, currency=ZAR → recommends Paystack → bulk imports products

🇬🇧

"Build a clothing store for the UK with Stripe and write the About page"

→ Sets country=GB, currency=GBP → Stripe → generates About page content

🇳🇬

"Create a Lagos-based sneaker store with Paystack and add 20 products"

→ Sets country=NG, currency=NGN → configures Paystack → adds products in bulk

✍️

"Write the About page for my hair salon, include our story and services"

→ Generates About page content → creates page → populates all blocks

🚀

"Publish the site and tell me the live URL"

→ Runs publish_website → returns live link at *.socialai.one

🛍️

"Add size variants S/M/L/XL to all my clothing products"

→ Reads products → adds variants to each one automatically

MCP tools, grouped by workflow

All 46 tools are documented and type-safe. The AI reads the descriptions and picks the right sequence automatically.

Setup
get_startedget_proactive_next_stepsget_intake_questionsquick_build
Sites
list_templatescreate_website_from_templatetransfer_website_to_templatemanage_websitesmanage_domainmanage_snapshotspublish_websiteexport_siteapply_site
Pages
manage_pagesupdate_page_blocksmanage_navigationgenerate_contentmanage_thememanage_postslist_block_typeslist_blocks
Store
manage_productsmanage_variantsmanage_categoriesmanage_pluginsmanage_shippingproduct_csvimport_products_from_urlimport_product_feedimport_product_spreadsheetmanage_ordersmanage_discounts
Payments
manage_store_settings
Business & team
manage_accountingmanage_teammanage_business_teamsmanage_team_invoicesmanage_feedback_surveys
Marketplace seller
manage_shop_seller
SAI Group
manage_sai_group
Media
manage_media
Support
report_issueget_preview_urlget_traffic_summarylist_leadsget_store_setup_preset

Block references for AI-assisted editing

The MCP includes list_blocks, so AI clients can show users real block names and reference links before adding headers, heroes, promo sections, product rows, forms, and footers.

Browse the block catalog →

Works everywhere — country-aware by default

Tell your AI which country the store is for and it automatically sets the right currency, recommends local payment providers, and uses the correct address format.

🇺🇸
United States
USD ($)
Stripe, PayPal, Square
🇬🇧
United Kingdom
GBP (£)
Stripe, PayPal
🇨🇦
Canada
CAD (C$)
Stripe, PayPal
🇦🇺
Australia
AUD (A$)
Stripe, PayPal
🇩🇪
Germany
EUR (€)
Stripe, PayPal
🇫🇷
France
EUR (€)
Stripe, PayPal
🇦🇪
UAE
AED
Stripe, PayPal
🇮🇳
India
INR (₹)
Razorpay, Stripe
🇧🇷
Brazil
BRL (R$)
Stripe, PayPal
🇲🇽
Mexico
MXN
Stripe, PayPal
🇿🇦
South Africa
ZAR (R)
Paystack, PayFast, Ozow
🇳🇬
Nigeria
NGN (₦)
Paystack, Flutterwave
🇰🇪
Kenya
KES (KSh)
M-Pesa, Paystack
🇬🇭
Ghana
GHS (GH₵)
Paystack, Flutterwave
🇪🇬
Egypt
EGP
Stripe, Fawry
🇸🇬
Singapore
SGD (S$)
Stripe, PayPal

16+ countries supported — just say which country your store is for and the AI handles the rest.

Ready to build?

Connect the hosted MCP with OAuth, enable Social AI in a new conversation, and tell your AI what to build.