analyze_funnel
ChatGPTRanks what to fix first: each link's rate and each price is improved by 10% in turn and the profit gained is measured with the real forecast, biggest gain first. Also warns about steps with no traffic, links adding up to over 100%, and purchase steps without a price. When ad campaigns (Google, Meta, Snapchat, TikTok) are linked to its steps, it adds a short "Plan vs real" section (last 30 days; get_actuals has the details). Use it to answer "what should I improve?".
create_funnel
ChatGPTCreates a new funnel in the workspace, empty or copied from a template (list_templates). Optionally pass "ops" to build it in the same call (the same ops as update_funnel). Returns its id and canvas link. Example: {"name":"Course launch, Egypt","businessType":"courses","ops":[{"op":"add_step","ref":"ad","element":"meta-ads","visitors":50000},{"op":"add_step","ref":"lp","element":"landing-page","after":"ad"},{"op":"connect","from":"ad","to":"lp","rate":1.2}]}
delete_funnel
ChatGPTDeletes a funnel for good, with its pictures, checklist and notes. It can NOT be undone. It needs the funnel's exact current name as "confirm", so it runs only on a clear request to delete that funnel.
get_activity
ChatGPTWhat the team, their AI and their API keys did in this workspace lately, newest first: funnels drawn and changed (each group of changes listed: steps, rates, prices, tasks…), numbers typed by hand, connections, people and the plan. Pass funnelId for one funnel's history. Useful before changing a funnel again, to see what changed since.
get_actuals
ChatGPTReal numbers from the Google Ads, Meta Ads, Snapchat Ads and TikTok Ads campaigns linked to this funnel's steps, beside the plan: first what the gap is worth (profit above or below the plan, at the plan's later rates), then per step: clicks and CPC against the plan (the funnel's monthly forecast scaled to the range; better or worse, by how much), conversions beside the plan's customers (not judged: the account may count other actions), and the real spend, impressions and CTR (impressions and CTR aren't compared: the platforms count every view, the plan people reached). Meta's and Snap's conversions are purchases, else leads, else sign-ups, as each campaign reports them; Snap's clicks are swipes. TikTok's are purchases (website, app and TikTok Shop), else website leads, else each ad group's optimization event. Dates are in each ad account's time zone; the default range is the last 30 full days (from / to, YYYY-MM-DD, at most 400 days). Amounts in another currency than the funnel's are converted to it (the funnel's own rate, else today's); one with no rate is shown as it is. If nothing is connected or linked, it says what to do next. Each figure comes with its source and range ("Meta Ads, 2026-09-12 → 2026-10-11"). Example: {"funnelId":"…","from":"2026-09-01","to":"2026-09-30"}
get_brief
ChatGPTWhat is known about the business a funnel is for (saved with set_brief): business type, offer and prices, revenue model, sales motion, markets and languages, goal, budget, baseline numbers and where each came from, plus the derived ticket band and regulated-vertical flags, how complete it is (core facts 0-6, overall %) and which core facts are missing. Read it before planning, writing copy or changing numbers.
get_funnel
ChatGPTA funnel's full picture: every step (id, label, type, phase, visitors, money, note), every link (from → to, rate), the checklist, notes excerpt, and the forecast (people, cost, revenue per step; totals with profit and ROAS). Read it before changing a funnel you didn't just build, to get step ids.
get_playbook
ChatGPTExpert know-how composed for this business (Markdown, short): funnel shapes for its type, qualification and nurture for its ticket and sales motion, channels, market rules (language and dialect of the copy, payments, seasons, consent) and what its vertical may and may not say. Call it before proposing a plan and before writing copy. Pass funnelId (its saved brief) or a draft brief, and optionally a focus.
get_prompts
ChatGPTReady-to-paste prompts for the AI tools a step needs, filled from this funnel (the brief, the step's copy, the steps around it): an AI video or design prompt for an ad (Higgsfield, Canva…), a site-builder prompt for a page (Webflow, Framer, Lovable, v0, Figma), or a copy prompt for ads, emails, WhatsApp and scripts. Without prompt it lists what the step offers (key, title, tools, angles) with the first one written out; with prompt (a key from that list) it writes that one, for tool and in the angle asked. Use them as the starting point when the person asks you to make the step's creative or copy, or hand the prompt to them for the other tool. They are only as specific as the brief: fill it first (set_brief) when key facts are missing; the result says which. Example: {"funnelId":"…","step":"Meta ad","prompt":"video-ad","angle":"ugc"}
get_report
ChatGPTA Markdown report of a funnel a person can read or paste: forecast totals, a per-step table (people, cost, revenue), the top 3 fixes with the profit each adds, warnings, the checklist, the Live report (the same plan-vs-real numbers as the Reports page: the funnel's KPIs, the biggest leak with what it costs, and which steps aren't measured yet and what would measure them, over the last days days, 30 by default), and a "Plan vs real" section per ad step when ad campaigns are linked.
get_results
ChatGPTReal results from the person's apps on this funnel's steps, beside the plan: sales (and revenue), leads or bookings counted from Shopify, Stripe, Gumroad, Typeform, Tally, Calendly, Cal.com and the rest, per step, with what the plan expected over the same days (the monthly forecast scaled to the range) and how far off it is. A step counts an app's events when it's linked to it in the canvas (the step's panel → Real results from your apps), optionally only one product, form or call type, or when the app's address sends them to that step. Range: the last 7, 30 (default) or 90 days, up to now. Each figure comes with its app and range ("Shopify, last 30 days"). Example: {"funnelId":"…","days":30}
get_workspace
ChatGPTThe Funnel Draw workspace this connection works in: its name, your role, whether its access is on (trial, paid, free or ended), how many funnels it may keep, and what this connection may do (read only, or create and change funnels). Call it first if you're unsure what you can do.
goal_seek
ChatGPTWorks back from a target profit (in the funnel's currency, per the funnel's period): how many times today's traffic it needs, or which single link to improve and to what rate instead. Saves nothing. Example: {"funnelId":"…","targetProfit":100000}
list_funnels
ChatGPTEvery funnel in the workspace, newest change first: id, name, number of steps, checklist progress and canvas link. Use the id with the other tools.
list_step_types
ChatGPTThe step types a funnel can use (the "element" of add_step): ads, organic sources, audiences, retargeting, pages, app steps, messages, sales, actions and logic. Filter by category or search words (e.g. "whatsapp", "checkout", "webinar"). Each says whether it takes a price (priceable), whether its cost is ad spend (adStep), whether it is an entry step, whether its visitors mean people who SEE it (reach: then its link rate is the click-through rate), what its real numbers are and where they come from (measures: its ad platform's campaigns, the apps that fit it, "soon", or nothing to measure), and its content fields.
list_templates
ChatGPTReady-made funnels to start from (pass the id to create_funnel as templateId): name, what it is for, business type and number of steps.
next_questions
ChatGPTThe interview engine: says the stage (core → confirm → sharpen → done), what is still unknown about the business, the 2-4 questions to ask next in one message (each with why it matters, answer bands, and a labelled default if they don't know), a one-line recap, and what to do now. Call it before planning a new funnel and after each round of answers (save the answers with set_brief first). Pass funnelId, or a draft brief before the funnel exists, or both. Example: {"brief":{"businessType":"high_ticket","pricePoints":[{"label":"12-week program","amount":5000,"role":"high_ticket"}],"currency":"GBP"}}
propose_funnels
ChatGPTThree funnels to offer before you draw one: the size that fits this business (from its monthly ad budget, its market's ad costs, its experience with ads and how many new ads it can make a month) between a smaller and a bigger one. Each has its paid channels, its steps and links (ready to draw), what it needs a month in the person's currency, and why. Use it at the confirm stage (next_questions says when). Each option's ops draw it, stages included, with create_funnel or update_funnel. Pass funnelId (its saved brief) or a draft brief. Example: {"funnelId":"…"}
record_numbers
ChatGPTKeeps real numbers the person tells you for a step whose numbers no app or platform sends here: an ad block whose platform isn't connected or has no campaign linked (Meta, Google, Snapchat, TikTok, LinkedIn, X…), WhatsApp, a store visit, offline, a marketplace. They're treated exactly like connected numbers: for a stretch of days (from, to, at most 92), the numbers its kind measures (list_step_types → measures): spend and clicks (and leads as count) on an ad block, orders as count and revenue as value on a sale, a count elsewhere. They're spread evenly over their days and count beside apps and campaigns in get_results, get_report and on the canvas. Money is in currency (default the funnel's) and converts to the funnel's. For numbers the person reports; it estimates nothing. Example: {"funnelId":"…","step":"<step id>","from":"2026-10-05","to":"2026-10-11","spend":1200,"clicks":640,"count":38}
rename_funnel
ChatGPTGives a funnel a new name (its steps, numbers and link stay the same).
run_forecast
ChatGPTThe funnel's forecast from its numbers: people entering, customers, revenue, ad spend, other costs, cost of sales, profit, ROAS and cost per customer, plus people, cost and revenue per step. Saves nothing.
suggest_tools
ChatGPTTools to run a step (ad managers, page builders, email, WhatsApp, booking, payments…), with links. Name a step type ("step", e.g. "meta-ads", "landing-page", "whatsapp") or a funnel ("funnelId": tools for each of its step types). budget: "free" (or 0) lists only tools with a free plan; any monthly amount lists them all.
update_funnel
ChatGPTThe main way to build and change a funnel: send a list of ops, applied in order, all or nothing (a failing op saves nothing and says what to fix). Returns the ids given to new steps (refs), warnings, the updated funnel with its forecast, and the canvas link. Ops (each an object with "op"; name steps by id, or by the "ref" you gave them earlier in the SAME call, or by their exact label when it's unique): - add_step: a new step. Fields: ref (your temp id, required), element (a step type key from list_step_types, required), label, after (step id/ref: placed one column to its right), phase (1-5, growth phase), visitors (people entering here; for ads/posts: people who SEE it), money, note, content (the type's fields). {"op":"add_step","ref":"ad","element":"meta-ads","label":"Meta Ads","phase":1,"visitors":50000,"money":{"costModel":"cpm","cost":40}} {"op":"add_step","ref":"lp","element":"landing-page","label":"Landing page","after":"ad"} {"op":"add_step","ref":"buy","element":"purchase","label":"Purchase","after":"lp","money":{"price":499}} Put prices on a purchase step (or an offer: order-bump, upsell, downsell; "priceable" in list_step_types): reaching it is what makes a customer. - update_step: change a step; money and content are merged, phase/visitors accept null to clear. Fields: step, label, subtitle, element, phase, visitors, money, note, content, stage (tofu|mofu|bofu|retain|none). {"op":"update_step","step":"lp","label":"Webinar page","money":{"cost":300,"costModel":"fixed"}} - remove_step: removes the step and its links. {"op":"remove_step","step":"<step id>"} - connect: a link between two steps. rate = % of the people at "from" who go to "to" (for an ad: its click-through rate). Links from one step should add up to 100% at most; a link without a rate shares what the rated ones leave. {"op":"connect","from":"ad","to":"lp","rate":1.5} {"op":"connect","from":"lp","to":"buy","rate":4,"label":"Buy now"} - update_link: name the link by "link" (its id) or by from + to. {"op":"update_link","from":"lp","to":"buy","rate":6} - disconnect: {"op":"disconnect","from":"lp","to":"buy"} or {"op":"disconnect","link":"<link id>"} - add_sticky: a sticky note on the canvas, optionally next to a step. {"op":"add_sticky","text":"Test 3 hooks first","near":"ad"} - update_task: fix a task (or a subtask) by id or exact text: new text, and for a task its subtasks as a whole list (ticks kept on the ones that stay). {"op":"update_task","task":"Write 3 ad hooks","text":"Write 5 ad hooks","items":["Pain","Proof","Offer","Story","Objection"]} - remove_task: delete a task or a subtask by id or exact text. {"op":"remove_task","task":"<task id>"} - add_frame: a stage of the funnel, drawn as a frame around its steps (a step sits in one frame). A funnel usually has 2-4 stages, named by what each part does: Traffic, Capture / Convert, Sales, Follow-up, After the sale. The funnel is laid out again so each stage's steps sit together. {"op":"add_frame","ref":"fe","label":"Front end","steps":["ad","lp","buy"]} - update_frame: rename a frame, or give it its steps again (a list replaces its steps). Name it by id, ref or exact name. {"op":"update_frame","frame":"Front end","label":"Get the lead","steps":["ad","lp"]} - remove_frame: removes the frame; its steps stay. {"op":"remove_frame","frame":"Front end"} - tidy: lays the whole funnel out left to right by flow (like Tidy up on the canvas): a step's branches either side of it, each frame's steps together, lines back around underneath. A new funnel, or a call adding 3+ steps, is laid out on its own; use it after small changes that left things crowded. {"op":"tidy"} - set_currency: the one currency every amount in the funnel is in (default USD): plans, real numbers and reports. Real numbers in other currencies (ad accounts, stores) always convert to it at the funnel's own rate or today's. With "convert": true, the planned prices and costs move from the old currency too, at the same rate; without it they keep their numbers. One of EGP, AED, SAR, KWD, QAR, BHD, OMR, JOD, MAD, TND, DZD, IQD, LBP, USD, CAD, MXN, …
what_if
ChatGPTApplies ops to a COPY of the funnel and compares the forecast before and after. Nothing is saved: use it to test ideas ("what if the landing page converts 6% instead of 4%?") before update_funnel. Takes the same ops as update_funnel. Example: {"funnelId":"…","ops":[{"op":"update_link","from":"Landing page","to":"Purchase","rate":6},{"op":"update_step","step":"Purchase","money":{"price":599}}]}