Documentation

A quick guide to getting the most out of FunnelMind.

1. Getting Started

From the Projects page, click New Project. Give your project a name, paste the URL of the product you're building a funnel for, and upload a product image (or paste an image URL). FunnelMind uses these to generate your first landing page automatically, and you'll be taken straight into the editor once it's ready.

2. The Funnel Editor

The editor is split into a chat panel and a live preview. Type instructions in the chat (e.g. "make the headline shorter" or "add a second testimonial") and the AI edits the page for you. You can also click directly on any element in the preview to open a quick-edit panel for colors, fonts, and text, or use the image editor tab to regenerate individual product images. Use Undo/Redo to step through changes, and Save to persist your work.

3. Previewing Your Funnel

Click Preview from the Projects list or the editor to open a read-only view of your saved page in a new tab, with a toggle between desktop and mobile layouts. Preview always reflects your last saved version, not unsaved edits.

4. Funnel Types

A funnel type is a content strategy matched to your traffic and buyer intent (for example, an advertorial-style page for cold traffic). The type you choose shapes how the AI structures and writes your page. You can browse available types from the "?" help link in the New Project dialog.

5. Connecting & Publishing to Shopify

Go to Stores and click Connect store — you'll install FunnelMind from the Shopify App Store, then confirm the connection with one click back in FunnelMind. Once a store is connected, open any funnel and click Publish to make it live on your storefront. Disconnecting a store inside FunnelMind does not uninstall the app — do that from your Shopify Admin under Settings → Apps.

5b. Connecting & Publishing to WordPress / WooCommerce

  1. Go to Stores, click Connect site and enter your site's address.
  2. Download the FunnelMind plugin from the same window. In WordPress, go to Plugins → Add New → Upload Plugin, upload the zip and activate it.
  3. In WordPress, open Settings → FunnelMind and paste the Site ID and signing secret. The secret is shown only once; the account owner can create a new one from Stores.
  4. Open any funnel and click Publish. The page goes live at https://your-site.com/fm/<page id>. Changes can take up to 5 minutes to show.

Your WordPress permalinks must not be set to "Plain" (Settings → Permalinks). Pages are served by the plugin, not copied into WordPress, so you edit them in FunnelMind. Only the account owner can disconnect a site or create a new secret.

6. Analytics

Once a store is connected, the Analytics page shows page views, sessions, CTA clicks, orders, and revenue — across your whole account, for a specific store, or for a single published funnel.

7. Billing & Plans

Plans include a monthly limit on how many funnels you can create, with a free trial available once per account. Manage your plan, view usage, or cancel from Account Settings. Cancelling stops future renewals; you keep access until the end of your current billing period. Shopify stores are billed through Shopify - view invoices and manage your payment method from your Shopify admin. WordPress / WooCommerce sites are billed by Stripe - view invoices and change your card from Account Settings.

8. Account & Data

You can delete an individual funnel at any time from the Projects list. To delete your account entirely or request a copy of your data, contact us via the Contact page — see our Privacy Policy for details.

9. Funnel API

The API lets your own tools create funnels for you. Send product links, and FunnelMind builds the pages in your account, the same way as the New Project button.

API tokens

  • Make a token in Account → API tokens. You need to be a member of at least one account on a paid plan.
  • You can have up to 3 active tokens. Revoke one to make a new one.
  • A token expires after 1 week, after 1 month, or never. You choose when you make it.
  • You see the token only once, when you make it. Copy it then. If you lose it, regenerate it: the old token stops working and you get a new one.
  • Send it on every call: Authorization: Bearer <token>. Keep it secret, like a password. Never put it in a web page, an email or a git repo.

Start funnels

POST https://funnel-mind.ai/api/v1/funnels

curl -s -X POST https://funnel-mind.ai/api/v1/funnels \ -H "Authorization: Bearer $FUNNELMIND_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{"account_id":"<your account id>", "product_url":"https://brand.com/products/x", "funnel_type":"advertorial"}'
FieldValues
account_idThe account the funnels go to. You must be a member, and it must be on a paid plan. You can leave it out only if you are in just one paid account. Find it in Account → API tokens under "Your account IDs" (with a Copy button), or on the Account Settings page.
product_urlOne full http(s):// link to a product page. Use this or items.
itemsA list of 1 to 20 funnels. Each item has a product_url.
funnel_typeadvertorial, listicle, comparison_review, offer_page, product_landing
modeboost (default, best quality) or normal (faster)
languageen (default), es, he
publishnone (default): create the funnel as a draft in the account. store: create and publish it to the account's connected Shopify store, like the Publish button. Publishing to a WordPress site from the API is coming soon; until then use none and publish from the editor.
storeOnly with publish: "store", and only when the account has 2 or more stores: the shop domain (for example brand.myshopify.com).
referenceOptional. An ad or page that works for you, so the new page follows its angle: { "url": "https://…" } (a landing page, a Meta Ad Library ad link or a public Google Drive file or folder), or { "image_urls": ["https://…"], "leads_to_url": "https://…" } (1 to 5 ad images and, if you have it, the page the ad leads to). Add note to say what to keep. Video links (TikTok, Reels, YouTube Shorts) are coming soon: until then the funnel is built without them. If the reference can't be read, the funnel is still built, and the check call says "reference": { "status": "skipped", "reason": "…" }.

Many funnels in one call: send items instead of product_url, up to 20. Fields at the top are the defaults. Any field on an item (funnel_type, mode, language, publish, store) wins over the default for that item. account_id is for the whole call.

{ "account_id": "<your account id>", "funnel_type": "advertorial", "publish": "none", "items": [ { "product_url": "https://brand.com/products/a" }, { "product_url": "https://brand.com/products/b", "funnel_type": "listicle", "language": "es" }, { "product_url": "https://brand.com/products/c", "publish": "store" } ] }

The answer lists one funnel for each item. Save each run_id.

202 { "funnels": [ { "run_id": "…", "project_id": "…", "product_url": "https://brand.com/products/x", "funnel_type": "advertorial", "publish": "none", "status": "building", "project_url": "https://funnel-mind.ai/…" } ] }

Sending the same product_url and funnel_type again within 24 hours returns the same run. It does not make a second funnel and does not use your quota.

Quota

  • API funnels count toward the account's monthly funnel limit, the same as funnels you make in the app. Funnels that are still building count too.
  • All or nothing: if a call asks for more funnels than the account has left, the whole call is rejected with not_enough_quota and the number left. Nothing starts.
  • Each token can start up to 20 funnels in 24 hours, or your plan's daily limit if that is lower. Above that, the call gets daily_limit_reached.

Check a funnel

GET https://funnel-mind.ai/api/v1/funnels/<run_id>

curl -s https://funnel-mind.ai/api/v1/funnels/<run_id> \ -H "Authorization: Bearer $FUNNELMIND_API_TOKEN"{ "run_id": "…", "project_id": "…", "status": "ready", "stage": "done", "publish": "store", "published_url": "https://brand.com/pages/…", "project_url": "https://funnel-mind.ai/…", "error": null }

status is one of:

  • building: still working. A Boost funnel takes about 40 minutes. Check every 5 minutes.
  • ready: done. project_url opens the funnel in the FunnelMind editor. With publish: "store", published_url is the live page on your store, and ready means it is already published.
  • failed: it could not be built or published. error says why.

Read your funnels and analytics

The same token reads your funnels and their numbers. account_id works the same as above. Analytics cover pages published to a connected Shopify store or WordPress site. Revenue is in USD.

GET /api/v1/accountsYour accounts: plan, funnels left this month, connected stores.
GET /api/v1/funnels?account_id=…The account's funnels, newest first. Filters: status (building, waiting, failed, draft, published), funnel_type, search, created_after; paging: limit (max 100), offset.
GET /api/v1/projects/<project_id>One funnel: status, live links, latest build.
GET /api/v1/analytics?account_id=…Totals, per store and per page for start_date to end_date (default the last 30 days, at most 365). Add store=<shop domain> or project_id=… to narrow it. Rates included: ctr_pct, conversion_rate_pct, aov_usd, revenue_per_visitor_usd.
GET /api/v1/compare?account_id=…&project_ids=a,b2 to 10 funnels side by side, with a verdict: which leads and whether the gap is big enough to trust.

Each token can make up to 60 calls a minute.

Errors

Errors come back as { "error": "<code>", "message": "…" }.

HTTPerrorWhat it means
400invalid_requestFix the body. message says what is wrong (for example, more than 20 items).
400account_requiredYou are in more than one paid account. Add account_id. The answer lists your accounts.
400no_store_connectedpublish is store, but the account has no connected store or site.
400store_requiredThe account has 2 or more stores or sites. Add store. The answer lists them.
401unauthorizedThe token is missing, wrong, revoked or expired.
403account_not_allowedYou are not a member of this account, or it is not on an active paid plan.
404not_foundNo such run or funnel in an account you are a member of.
429daily_limit_reachedToo many funnels from this token in 24 hours. requested and left give the numbers.
429not_enough_quotaThe account does not have enough funnels left this period for the whole call.
429rate_limitedMore than 60 calls in a minute from this token. Wait a minute.
503unavailableThe service is paused or could not start. Try again in a few minutes.
500internal_errorOur bug. Contact us with the request_id.

10. Use FunnelMind from AI tools (MCP)

MCP (Model Context Protocol) is the standard way AI tools such as Claude, ChatGPT, Cursor and VS Code connect to other services. Connect FunnelMind once, then just ask: "How did my pages do last week?", "Which of these two advertorials converts better?", "Make listicles for these 3 product links."

Set it up

The server address is https://mcp.funnel-mind.ai. Add it to your AI tool, then sign in with your normal FunnelMind login and click Allow. There is no token to copy. You need a paid plan.

  • Claude (claude.ai, Claude Desktop, mobile): Settings → Connectors → Add custom connector → paste the address → Add → Connect.
  • ChatGPT: turn on developer mode in Settings, add a connector with the address, then sign in.

Claude Code (in a terminal, then type /mcp and choose Authenticate):

claude mcp add --transport http funnelmind https://mcp.funnel-mind.ai

Cursor (~/.cursor/mcp.json) or VS Code: add the server, and the tool opens the FunnelMind sign-in.

{ "mcpServers": { "funnelmind": { "url": "https://mcp.funnel-mind.ai" } } }

Or use an API token

For scripts and tools that can't sign in. Make a token in Account → API tokens and replace YOUR_API_TOKEN with it. The same steps, with Copy buttons, are in Account → AI tools (MCP).

Claude Code:

claude mcp add --transport http funnelmind https://mcp.funnel-mind.ai --header "Authorization: Bearer YOUR_API_TOKEN"

Cursor (~/.cursor/mcp.json):

{ "mcpServers": { "funnelmind": { "url": "https://mcp.funnel-mind.ai", "headers": { "Authorization": "Bearer YOUR_API_TOKEN" } } } }

VS Code (.vscode/mcp.json; it asks for the token once):

{ "servers": { "funnelmind": { "type": "http", "url": "https://mcp.funnel-mind.ai", "headers": { "Authorization": "Bearer ${input:funnelmind-token}" } } }, "inputs": [ { "type": "promptString", "id": "funnelmind-token", "description": "FunnelMind API token", "password": true } ] }

What your AI tool can do

list_accountsYour accounts, plan, funnels left this month and connected stores.
list_funnelsYour funnels, with status (building, draft, published…) and live links. Filter by status, type, text or date.
get_funnelOne funnel: details, live links and build status.
get_analyticsViews, sessions, clicks, add to cart, checkouts, orders, revenue, CTR, conversion rate, AOV: for the account, a store or one page.
compare_pages2 to 10 pages side by side, which one leads, and whether the gap is big enough to trust.
create_funnelsStart 1 to 20 funnels from product links, optionally built on an ad, page or video you like (uses your monthly funnels). Your AI tool asks you first.
get_funnel_statusIs it ready yet? Building, ready or failed, with the links.
create_adsMake 6 to 15 Meta ads (images and up to 3 videos) for one of your pages.
get_adsThe ads of a page: text, images, videos and whether they are ready.
update_ad, remake_adChange an ad's text or call to action, or make a new take of it.
send_ads_to_metaSend the ads to your Meta ad account as a new campaign. It starts paused; you turn it on in Meta Ads Manager.
get_ad_resultsSpend, clicks, cost per click and results from Meta for the last 7 or 30 days.
list_brands, get_brand_rulesYour brands (one per website) and the brand rules every new page follows.
add_brand_rules, update_brand_rule, delete_brand_ruleAdd, change or delete brand rules. FunnelMind checks each one: saved, already there, conflicts with a rule, or blocked (like fake reviews).
answer_brand_rule_suggestionAccept or dismiss a rule FunnelMind suggested from your edits.
refresh_brand_kitTake a new logo, colours and fonts from the brand's website for its next funnel.

Limits and privacy

  • The same rules as the Funnel API: paid plan, your monthly funnels, 20 new funnels a day per connection, 60 calls a minute.
  • Your AI tool asks you before it changes anything: new funnels, ads, brand rules. Reading pages and numbers needs no extra step. Ads go to Meta paused; you turn them on in Meta Ads Manager.
  • Your AI tool sees what the tools return: funnel names, links and numbers. It never gets your token back, other members' emails, or page code.
  • To disconnect, remove the server from your AI tool, or click Disconnect in Account → AI tools (MCP) (for a token: revoke it in Account → API tokens).