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
- Go to Stores, click Connect site and enter your site's address.
- Download the FunnelMind plugin from the same window. In WordPress, go to Plugins → Add New → Upload Plugin, upload the zip and activate it.
- 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.
- 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"}'| Field | Values |
|---|---|
account_id | The 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_url | One full http(s):// link to a product page. Use this or items. |
items | A list of 1 to 20 funnels. Each item has a product_url. |
funnel_type | advertorial, listicle, comparison_review, offer_page, product_landing |
mode | boost (default, best quality) or normal (faster) |
language | en (default), es, he |
publish | none (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. |
store | Only with publish: "store", and only when the account has 2 or more stores: the shop domain (for example brand.myshopify.com). |
reference | Optional. 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_quotaand 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_urlopens the funnel in the FunnelMind editor. Withpublish: "store",published_urlis the live page on your store, andreadymeans it is already published.failed: it could not be built or published.errorsays 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/accounts | Your 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,b | 2 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": "…" }.
| HTTP | error | What it means |
|---|---|---|
| 400 | invalid_request | Fix the body. message says what is wrong (for example, more than 20 items). |
| 400 | account_required | You are in more than one paid account. Add account_id. The answer lists your accounts. |
| 400 | no_store_connected | publish is store, but the account has no connected store or site. |
| 400 | store_required | The account has 2 or more stores or sites. Add store. The answer lists them. |
| 401 | unauthorized | The token is missing, wrong, revoked or expired. |
| 403 | account_not_allowed | You are not a member of this account, or it is not on an active paid plan. |
| 404 | not_found | No such run or funnel in an account you are a member of. |
| 429 | daily_limit_reached | Too many funnels from this token in 24 hours. requested and left give the numbers. |
| 429 | not_enough_quota | The account does not have enough funnels left this period for the whole call. |
| 429 | rate_limited | More than 60 calls in a minute from this token. Wait a minute. |
| 503 | unavailable | The service is paused or could not start. Try again in a few minutes. |
| 500 | internal_error | Our 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, 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
- Make an API token in Account → API tokens (paid plan needed).
- Add the server to your AI tool. The address is
https://mcpdev.funnel-mind.ai. ReplaceYOUR_API_TOKENwith your token. The same steps, with Copy buttons, are in Account → AI tools (MCP).
Claude Code (in a terminal):
claude mcp add --transport http funnelmind https://mcpdev.funnel-mind.ai --header "Authorization: Bearer YOUR_API_TOKEN"Cursor (~/.cursor/mcp.json):
{
"mcpServers": {
"funnelmind": {
"url": "https://mcpdev.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://mcpdev.funnel-mind.ai",
"headers": { "Authorization": "Bearer ${input:funnelmind-token}" }
}
},
"inputs": [
{ "type": "promptString", "id": "funnelmind-token",
"description": "FunnelMind API token", "password": true }
]
}Claude (claude.ai, Desktop, mobile): Settings → Connectors → Add custom connector → paste https://mcpdev.funnel-mind.ai, then sign in with FunnelMind. No token to paste. ChatGPT: add it as a connector with the same address (needs developer mode until FunnelMind is in the ChatGPT directory).
What your AI tool can do
list_accounts | Your accounts, plan, funnels left this month and connected stores. |
list_funnels | Your funnels, with status (building, draft, published…) and live links. Filter by status, type, text or date. |
get_funnel | One funnel: details, live links and build status. |
get_analytics | Views, sessions, clicks, add to cart, checkouts, orders, revenue, CTR, conversion rate, AOV: for the account, a store or one page. |
compare_pages | 2 to 10 pages side by side, which one leads, and whether the gap is big enough to trust. |
create_funnels | Start 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_status | Is it ready yet? Building, ready or failed, with the links. |
Limits and privacy
- The same rules as the Funnel API: paid plan, your monthly funnels, 20 new funnels a day per token, 60 calls a minute.
- Your AI tool asks you before it creates funnels. Reading pages and numbers needs no extra step.
- 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 revoke its token in Account → API tokens.