Documentation Index Fetch the complete documentation index at: https://docs.fourthwall.com/llms.txt
Use this file to discover all available pages before exploring further.
The Fourthwall MCP server gives AI assistants direct access to your shop data — products, orders, promotions, collections, analytics, and more.
What You Can Do Once connected, you can ask your AI assistant things like:
“Show me my top-selling products this month” “List all unfulfilled orders from the past week” “What’s my conversion rate compared to last month?” “Find all orders from customer@example.com ” “What are my sales by country this quarter?” “How many active members do I have?” “Search help docs for how to set up shipping profiles”
Connect to the MCP Server Server URL: https://mcp.fourthwall.com (Streamable HTTP) Claude Desktop
Claude Code
Cursor
VS Code
Gemini CLI
Other Clients
Open Claude settings and navigate to Connectors
Select Add custom connector
Enter name: Fourthwall
Enter URL: https://mcp.fourthwall.com
Select Add
You’ll be prompted to log in with your Fourthwall account
Run in your terminal: claude mcp add --transport http fourthwall https://mcp.fourthwall.com
On first use, you’ll be redirected to log in with your Fourthwall account.
Open command palette (Cmd+Shift+P / Ctrl+Shift+P)
Search for Open MCP settings
Add to your mcp.json:
{ "mcpServers" : { "fourthwall" : { "url" : "https://mcp.fourthwall.com" } } }
Open command palette (Cmd+Shift+P / Ctrl+Shift+P)
Search for MCP: Add Server
Select HTTP
Enter URL: https://mcp.fourthwall.com
Enter name: fourthwall
Add to your ~/.gemini/settings.json: { "mcpServers" : { "fourthwall" : { "httpUrl" : "https://mcp.fourthwall.com" } } }
Any MCP-compatible client can connect using the Streamable HTTP transport:
URL: https://mcp.fourthwall.comTransport: Streamable HTTPAuthentication: OAuth 2.0 (initiated automatically on first connection) Authentication The MCP server uses OAuth 2.0 to authenticate with your Fourthwall account. When you connect for the first time:
Your AI client opens a browser window to Fourthwall’s login page
You log in with your existing Fourthwall credentials
You select which shop to connect (if you manage multiple shops)
The session is established — you’re ready to go
The MCP server provides read-only access to your shop data across the following categories.
Search & Knowledge Tool Description omni_searchSearch across orders, products, promotions, and collections by name, email, or ID omni_knowledgeSearch Fourthwall’s help docs and knowledge base
Products & Catalog Tool Description ecommerce_get-offersList all products in your shop ecommerce_get-offers-by-idsGet specific products by ID ecommerce_get-catalog-productsBrowse the Fourthwall product catalog ecommerce_get-catalog-products-by-slugsGet catalog products by URL slugs ecommerce_get-catalog-product-detailsGet details for a catalog product
Orders & Fulfillment Tool Description ecommerce_get-ordersList orders with filters ecommerce_get-orders-statisticsGet order statistics and summaries ecommerce_get-order-details-by-idsGet full details for specific orders ecommerce_get-unfulfilled-ordersList orders awaiting fulfillment ecommerce_get-order-cancellation-by-idsCheck cancellation status ecommerce_get-fulfillment-detailsGet fulfillment tracking information
Collections Tool Description ecommerce_get-collectionsList all collections ecommerce_get-collections-by-idsGet specific collections
Tool Description ecommerce_get-promotionsList all promotions ecommerce_get-promotions-by-idsGet specific promotions
Analytics & Reports Tool Description ecommerce_get-sales-over-time-reportRevenue over a date range ecommerce_get-top-products-by-units-sold-reportBest-selling products ecommerce_get-average-order-value-reportAverage order value trends ecommerce_get-conversion-rates-reportStorefront conversion rates ecommerce_get-visitors-reportVisitor traffic data ecommerce_get-sales-by-country-reportRevenue breakdown by country ecommerce_get-sales-by-source-reportRevenue by traffic source ecommerce_get-sales-by-utm-reportRevenue by UTM campaign ecommerce_get-sessions-by-source-reportSessions by traffic source ecommerce_get-customers-over-time-reportCustomer growth over time ecommerce_get-total-profit-reportTotal profit overview ecommerce_get-contributions-per-type-reportRevenue by product type ecommerce_get-payment-method-used-reportPayment method breakdown ecommerce_get-affiliate-earnings-reportAffiliate earnings summary
Memberships Tool Description ecommerce_get-membership-active-members-reportActive members overview ecommerce_get-membership-new-members-reportNew member signups ecommerce_get-membership-cancelled-members-reportCancellation data ecommerce_get-membership-free-trials-reportFree trial activity ecommerce_get-membership-free-accounts-reportFree account data ecommerce_get-membership-tier-activity-reportActivity by tier ecommerce_get-membership-top-tiers-by-new-members-reportTop-performing tiers
Integrations & Shipping Tool Description ecommerce_get-all-integrationsList connected integrations ecommerce_get-tiktok-configurationTikTok integration settings ecommerce_get-tiktok-productsTikTok product sync status ecommerce_get-youtube-integrationsYouTube integration settings ecommerce_get-youtube-productsYouTube product sync status ecommerce_get-shipping-profilesShipping profile configuration ecommerce_get-shipping-flat-ratesFlat rate shipping settings ecommerce_get-dns-entriesCustom domain DNS records ecommerce_validate-dns-entriesValidate DNS configuration
Shop & Account Tool Description ecommerce_get-current-shopYour shop details ecommerce_get-current-subscriptionYour current Fourthwall plan ecommerce_get-available-plansAvailable plan options ecommerce_get-subscription-limitsPlan limits and usage ecommerce_get-shop-permissionsYour account permissions ecommerce_get-user-connectionsShops connected to your account ecommerce_get-payout-infoPayout configuration ecommerce_get-payout-transactionsPayout transaction history ecommerce_get-sample-credit-balanceSample credit balance ecommerce_get-personalized-recommendationsPersonalized product recommendations
Send Feedback The MCP server includes a built-in send-feedback tool that lets you report issues or request features directly from your AI conversation.
You can ask your assistant things like:
“Send feedback that the orders search is slow when filtering by date range” “Submit a feature request for bulk order export”
Your feedback goes directly to the Fourthwall team along with relevant conversation context, so we can understand and address it quickly.
Troubleshooting I can’t connect or authenticate
Make sure you have a Fourthwall account with dashboard access
Try disconnecting and reconnecting the MCP server in your client
Check that your client supports the Streamable HTTP transport
Tools are missing or unavailable
Make sure you’ve selected a shop after authenticating
Reconnect the MCP server if tools don’t appear after login
I’m getting errors on tool calls
Verify you have the correct permissions for the action (e.g., Super Admin or Manager for some operations)
Check that the entity IDs you’re referencing exist in your shop
Use send-feedback to report persistent issues — include what you were trying to do
LLM Support Documentation files and MCP server for AI code editors
Platform API RESTful API for direct programmatic access
Authentication API key and OAuth authentication guides
Community Join our Discord for help and discussions
