Funnels integration
FunnelKit AI agent tool reference
WP MCP Pro works with FunnelKit on the theme dispatcher pair. On theme-read, list-funnelkit-funnels returns funnels newest first with a step summary, get-funnelkit-funnel returns one funnel's steps in order, each with its type, linked page, status, linked product ids and basic counts from the tables FunnelKit's own canvas reads, and get-funnelkit-checkout-products reads a checkout step's products. On theme-write, agents create, rename and delete funnels, add, reorder, enable, disable, publish and delete steps, and set or remove checkout products with quantity and discount, all through FunnelKit itself (the free Funnel Builder) so its own hooks run. Creates and updates accept dry_run, which validates and reports what would change, including the price a buyer would pay, without writing anything. Every write is snapshotted first and rollback-operation undoes it; undoing a funnel change needs FunnelKit's own permission to edit funnels. Some numbers depend on paid FunnelKit add-ons: the free plugin records no views, so views and view-based conversions need the paid add-on, and upsell offers need the upsell add-on. Where a value cannot be read it comes back null with a sibling key saying why, never a misleading zero. Only COUNT and SUM results leave the stats tables, so no optin emails, form data or order ids reach the agent.
FunnelKit in plain language: FunnelKit MCP.
In practice
How FunnelKit work goes with an agent.
FunnelKit keeps a funnel as a row in its bwf_funnels table with an ordered list of steps, and each step is a post of its own FunnelKit type: wffn_landing, wfacp_checkout, wffn_ty and so on. Views and conversions sit in separate report tables, and which of them exist depends on the paid add-ons. That is why a funnel comes back as steps in order, each with a linked page, products and counts, and why some numbers are null with a reason code. Writes go through FunnelKit's own REST handlers, so its permission check and hooks run.
Which steps of the Black Friday funnel are still drafts, and what does its checkout charge?
Runs get-funnelkit-funnel for the step list and statuses, then get-funnelkit-checkout-products with the checkout step id, which returns quantity, discount and the unit and line price after discount. Both are reads, so nothing is snapshotted.
Add a thank-you step to funnel 3, but show me what would change first.
Runs add-funnelkit-step with type wc_thankyou and dry_run:true, which reports the step it would add and its position without writing. Dropping dry_run writes it, after the whole funnel is snapshotted.
Put 20 percent off the sale price on product 88 at the checkout, quantity 2.
Runs set-funnelkit-checkout-products with discount_type percent_discount_sale. Each line answers its effective unit and line price, worked out with FunnelKit's own discount function, and dry_run previews the same numbers without a write.
Publish every step of funnel 3 and move the optin to the front.
Runs publish-funnelkit-steps (dry_run lists the drafts it would publish) and reorder-funnelkit-steps, where step_ids must name every step once. Each write snapshots the funnel and can be undone separately.
What your AI can do
Real FunnelKit operations, every write reversible.
- List funnels with a step summary
- Read a funnel's steps in order with linked pages and products
- See order and optin counts per step, and views and offers where the paid add-ons record them
- Create, rename and delete funnels, with a dry run first
- Add, reorder, enable, disable, publish and delete steps
- Set or remove checkout products with quantity and discount, seeing the buyer's price with dry_run
- Undo any funnel, step or checkout-product change with rollback-operation
Example prompts
Example FunnelKit prompts.
List my funnels and how many steps each has.
Walk me through the Summer Sale funnel step by step.
Create a Summer Sale funnel with an optin, a checkout and a thank-you step, and show me the plan before you save it.
Under the hood
The FunnelKit calls, under the hood.
theme-read({ operation: "get-funnelkit-funnel", args: { id: 3 } }), counts only, *_unavailable says why
theme-write({ operation: "create-funnelkit-funnel", args: { title: "Summer Sale", dry_run: true } }), previews; drop dry_run to write, snapshotted
Safety and access
What can be undone on FunnelKit, and what costs what.
Recoverable on FunnelKit
- Each write that is not a dry run snapshots the whole funnel: its row, its meta rows and every step post with its meta.
- rollback-operation puts back exactly the funnel that was there, including a deleted funnel or step at its own id and place.
- Undoing create-funnelkit-funnel deletes the new funnel again.
- An undo takes back only what that one write changed, and needs FunnelKit's own permission to edit funnels.
FunnelKit limits and opt-ins
- delete-funnelkit-funnel, delete-funnelkit-step and remove-funnelkit-checkout-products are destructive ops and need confirm:true. They are still snapshotted and reversible.
- Steps it can add are landing, wc_checkout, wc_thankyou, optin and optin_ty. Upsell steps, order bumps, upsell offers and A/B experiments are not covered.
- One set-funnelkit-checkout-products call takes up to 50 products, and reorder-funnelkit-steps takes up to 100 step ids.
- A variable product has no single price until a buyer picks a variation, so its prices come back null with a reason.
Free or Pro: Every FunnelKit op is Pro, on the theme-read and theme-write pair, and the free plugin has none of them. They work with the free FunnelKit Funnel Builder. The paid FunnelKit add-ons only change what can be read: views, view-based conversions and upsell offers are null without them. These writes carry no separate opt-in filter, but each needs manage_woocommerce on top of FunnelKit's own access check, and deletes need confirm:true.
Part of WP MCP Pro
The FunnelKit integration is part of WP MCP Pro.
One Pro licence unlocks the FunnelKit tools and every other Pro integration on this site: Elementor deep editing, the other page builders, the forms adapter pack and more, 133 Pro tools in all. The free plugin still covers the rest of WordPress and the full snapshot and undo engine, so you can try the safety model before you buy.
Frequently asked
FunnelKit MCP: questions, answered.
With FunnelKit, can the agent edit funnels?
Yes, on Pro. Funnels, steps and checkout products are changed through FunnelKit's own code, so its hooks run, and every change is snapshotted so rollback-operation undoes it. Undoing a funnel change requires FunnelKit's own permission to edit funnels. Editing the pages a step links to still goes through the regular content and builder tools, snapshotted.
Why are some counts null?
The free FunnelKit plugin does not record views, and offers live in the upsell add-on. Without those add-ons the value is null and the response says which add-on it needs.
Does a dry run take a snapshot or write anything?
No. dry_run validates the request, reports what would change and writes nothing, so no snapshot is taken. It is accepted by create, rename, add step, reorder, set step status, publish all and set checkout products. Deletes have no dry run; they ask for confirm:true instead.
Can the FunnelKit integration add an upsell step or an order bump?
No. The free Funnel Builder can add landing, checkout, thank-you, optin and optin thank-you steps, and that is the set this integration adds. Order bumps, upsell offers and A/B experiments live in Funnel Builder Pro and its add-ons, so an agent can read an upsell step's offers but not build them.
Why does get-funnelkit-funnel return null for some counts?
Each null comes with a sibling key and a reason code, such as pro_addon_inactive, upsell_addon_inactive, table_missing or counted_per_offer. It means FunnelKit does not record that value on this site, not that the count is zero, so an agent should not report it as zero.
Which permissions does a funnel write need?
The WordPress user behind the MCP connection needs manage_woocommerce, like the reads, and FunnelKit's own access check must also pass. By default that means administrators. If FunnelKit refuses, the op answers funnelkit_access_denied and nothing changes.
Related integrations
More integrations for the same agent.
MCP for WooCommerce
FreeE-commerce, 9 tools.
MCP for GiveWP
FreeDonations, 3 tools.
MCP for FluentCRM
ProCRM & email, 2 tools.
MCP for MailPoet
ProCRM & email, 2 tools.
MCP for Elementor
ProPage builders, 14 tools.
MCP for Gutenberg
FreePage builders, 4 tools.
Browse the full Integrations hub, or read more on FunnelKit MCP, MCP for WooCommerce and the WordPress MCP plugin.