Your agent finds these tools when it connects to https://app.granvl.com/api/mcp (see Connect your agent). This page tells you what each tool is for. The agent reads the exact arguments and limits from the server, so you never need to copy parameters from here. Install the granvl skill before your agent builds anything: it tells the agent which tools to call, in what order.

How your agent sees the list

Essential tools come first. The server lists the session-start tools, the build loop, the Tool credit tools, and the main performance reads before everything else. Some agents only keep the first part of a long tool list, so the important ones always arrive.
Core tools are always listed. That covers everything in the first two sections below.
Ad-platform tools appear once an ad account is connected. The Meta Ads and Google Ads build tools are listed after the workspace connects an ad account. To list everything without connecting one, add ?tools=all to the server URL: https://app.granvl.com/api/mcp?tools=all.
Unlisted tools still work. A tool your agent was not shown still runs when the agent calls it by name. If your agent says granvl can't do something, ask it to check this reference or call the tool by name.

You can ask your agent for its current list at any time:

List the granvl tools you can see, grouped by area. Tell me if any ad-platform tools are missing.

Controls agents can't skip

Confirmation before irreversible actions. Deleting a funnel, page, variant, website page, lead magnet, form destination, campaign draft, research document, or research folder, and publishing or unpublishing a funnel or website, take two steps. The first call changes nothing and returns a summary. Your agent shows it to you, and only after you say yes does the second call run. The approval lasts 10 minutes and covers those exact arguments only.
Ads arrive paused. Every campaign, ad set, ad group, and ad an agent creates on Meta or Google is created paused. You turn it on in the ad platform.
Budgets have limits. Daily budgets are capped by your Ad Guardrails settings, and a Google campaign budget change waits for a person to approve it on the Google Ads page.
Credit spending has limits. Tools that spend Tool credits check your balance and the workspace's spend guard first. See Use Tool credits.

Essential tools

Start a session

Tool	What it does
`get_skill`	Returns the granvl skill (SKILL.md plus an index of its resource files) so the agent follows granvl's building and tracking rules.
`get_workspace_context`	Reads the workspace memory file: business, brands, audience, voice, and past learnings. Agents call it first.
`update_workspace_context`	Rewrites the workspace memory file.
`list_workspaces`	Lists your workspaces and shows which one this connection is using.
`switch_workspace`	Moves the connection to another of your workspaces. Not available on API-key connections, which stay on one workspace.
`get_profile`	Returns the signed-in user and the active workspace.
`get_credits`	Shows your Tool credits, SMS verification credits, and the month's email and phone validation allowances.
`list_capabilities`	Lists the image, video, and research models your workspace can use, with rough prices and your balance.

Build funnels and pages

Tool	What it does
`list_funnels`	Lists your funnels with status, domain, and pages, most recently updated first.
`get_funnel`	Returns one funnel with all its pages, variants, and preview URLs.
`create_funnel`	Creates a funnel. The agent picks the funnel type and the ad platform it's for.
`update_funnel`	Changes a funnel's name, ad platform, domain, or brand.
`list_pages`	Lists a funnel's pages with slugs, types, and variant counts.
`create_page`	Adds a page (landing, quiz, form, or thank-you) to a funnel.
`update_page`	Changes a page's name, slug, or type.
`publish_funnel`	Checks every variant, fixes mechanical issues, and puts the funnel live. Asks for your confirmation.
`unpublish_funnel`	Takes the funnel offline. Pages and history are kept. Asks for your confirmation.
`create_preview_link`	Creates a shareable 7-day preview of the whole funnel. Previews record no analytics.

Write and test variants

Tool	What it does
`get_variant`	Returns one variant with its details and preview URL.
`get_variant_html`	Returns a variant's current HTML so the agent edits it instead of starting over.
`create_variant`	Adds a new A/B test variant to a page.
`update_variant`	Replaces a variant's HTML, details, or traffic weight.
`patch_variant_html`	Changes one part of a page by exact find-and-replace and leaves the rest untouched.
`bulk_create_variants`	Creates several variants on one page in a single call.
`duplicate_variant`	Copies a variant so the agent can change the copy without touching the original.
`set_weights`	Sets the traffic split for a page's variants. Weights add up to 100.

Start from templates

Tool	What it does
`list_templates`	Lists granvl's funnel templates.
`get_template`	Shows a template's pages and variants so the agent can judge the fit.
`get_page_scaffold`	Returns the standard HTML skeleton for a page type, ready to fill in.
`create_funnel_from_template`	Creates an unpublished funnel from a template for the agent to adapt.

Brands, domains, forms, and images

Tool	What it does
`get_brand_kit`	Reads a domain's brand kit: colors, fonts, and corner radius.
`update_brand_kit`	Writes a domain's brand kit.
`list_brands`	Lists the workspace's brands with funnel and domain counts.
`list_domains`	Lists your domains, optionally for one brand.
`create_domain`	Adds a domain. It stays pending until DNS is set up and verified.
`verify_domain`	Checks the domain's DNS records and activates it when they're right.
`get_domain_dns_records`	Returns the exact records to add at your DNS provider.
`get_form_destinations`	Lists a funnel's lead destinations and the form fields they expect.
`set_form_destination`	Connects a destination by pasting a URL or vendor embed (webhook, Zapier, GoHighLevel, HubSpot, ActiveCampaign, Formspree, Lead Prosper, and more).
`upload_image`	Uploads an image and returns a hosted URL for page HTML.

Research and generation (Tool credits)

These tools spend Tool credits unless the line says otherwise. Tools that cost more first return an estimate the agent shows you.

Tool	What it does
`generate_image`	Generates an image with a chosen model and saves it to the workspace. Charged only on success.
`generate_video`	Starts a video generation job. Charged only when the video completes.
`poll_video_generation`	Checks a video job and returns the finished video.
`research_web`	Answers a specific marketing question with cited sources.
`research_competitor_ads`	Finds the ads a competitor or a whole niche is running now and saves them to Research. Estimates the cost first.
`research_landing_page`	Tears down any landing page: headline, offer, form, prices, and trust signals, with a screenshot. Estimates the cost first.
`list_competitor_ads`	Lists competitor ads already saved in the workspace. Free.
`save_competitor_insights`	Files the agent's own summary of each saved ad's offer, hook, and angle. Free.
`start_offer_research`	Starts a twelve-section research report on an offer and files it in Research. Estimates cost and time first.
`start_niche_research`	Starts the same report for a niche with no specific offer.
`start_breakout_research`	Starts a focused follow-up report on one offer or angle from an existing report.
`poll_offer_research`	Checks a research job and returns the filed report.
`deepen_offer_research`	Adds quotes, competitors, objections, or fresh keyword and ad pulls to an existing report.
`list_creative_formats`	Lists granvl's library of proven Meta ad formats with previews.
`get_creative_format`	Returns the full brief for one ad format.
`compose_creative_brief`	Turns the agent's concept into a ready-to-render image prompt in a chosen format. Free.
`research_keywords`	Pulls keyword volume, CPC, and competition for seeds, a landing page, or competitor domains.
`classify_keywords`	Sorts keywords or search terms by buying intent. Free.
`build_keyword_plan`	Turns keyword rows into themes, match types, starting bids, and day-one negatives. Free.
`plan_search_campaign`	Plans a Google Search campaign in one call, from keyword research to campaign structure, and saves the plan.
`triage_search_terms`	Pulls recent search terms from a connected Google Ads account and sorts them into keep, review, and suggested negatives. Changes nothing.

Read performance

Tool	What it does
`get_daily_brief`	Reads the workspace's once-a-day summary of traffic, conversions, changes, and spend.
`get_funnel_stats`	Returns a funnel's visitors, conversions, click-throughs, and per-variant results for a date range.
`get_variant_stats`	Returns one variant's results for a date range.
`get_funnel_summary`	Returns a short outline of a funnel: pages, slugs, and live variant counts.
`get_funnel_timeseries`	Returns a funnel's results per day or week, for trend questions.
`get_segmented_stats`	Breaks a funnel's results down by one dimension, such as source, device, or campaign.
`get_funnel_analysis`	Reads the latest saved daily analysis of a funnel, with ranked recommendations.
`get_step_funnel`	Shows step-by-step drop-off for a quiz or multi-step page.
`get_spend_summary`	Joins ad spend to granvl conversions and qualified leads per campaign and ad set, with cost per lead.
`get_tracking_health`	Audits every synced ad for dead destinations and missing or broken UTMs, with the fix for each.
`get_ad_entities`	Reads the synced campaigns, ad sets, and ads with their status and destination URLs.
`list_optimization_actions`	Lists what auto-optimize did: paused variants, flagged leaders, new variants.
`get_optimization_suggestions`	Suggests next moves for a funnel, such as promoting a winner or starting a test.
`get_research_history`	Returns what the workspace has already tested, including what failed.
`save_learning`	Records a test conclusion so future work builds on it.
`list_learnings`	Lists recorded learnings, optionally for one funnel.

More core tools (always listed)

Strategy, research library, and copy

Tool	What it does
`get_strategy_brief`	Returns one product, audience, and angle brief with its evidence and gaps.
`get_copy_brief`	Returns the strategy brief plus existing copy and the copy still missing for an ad or page.
`list_research_documents`	Lists the Research library's folders and documents.
`get_research_document`	Reads one research document or report, as Markdown or as a standalone HTML page.
`create_research_document`	Creates a foundation document in the Research library.
`update_research_document`	Changes a document's title, folder, tags, status, or whether agents use it as context.
`update_research_section`	Replaces one section of a foundation document. Every change is versioned.
`replace_research_document`	Replaces a foundation document's whole body. The old text stays in its history.
`delete_research_document`	Deletes a research document. Asks for your confirmation.
`list_research_document_versions`	Lists a document's saved versions.
`restore_research_document_version`	Restores an earlier version. The current text is saved first.
`create_research_folder`	Creates a folder in the Research library.
`update_research_folder`	Renames, moves, or retags a research folder.
`delete_research_folder`	Deletes an empty research folder. Asks for your confirmation.
`attach_research_evidence`	Files an evidence row under a foundation document.
`save_research_evidence`	Saves cited findings as evidence rows in Research. Free.
`list_copy_lines`	Reads the Copywriting library of headlines and ad copy.
`create_copy_lines`	Saves a batch of new copy lines, each with a one-line rationale.
`update_copy_line`	Edits a copy line or changes its status.

Websites

Your brand website: a fixed set of pages that share one header, footer and main button. See Build and publish a brand website.

Tool	What it does
`create_website`	Creates a brand's website, with a header and footer from its brand kit. One website per brand.
`get_website`	Returns one website: each page's status, the shared layout, the main button, the domain, and publish state.
`list_websites`	Lists the workspace's websites with publish state and page counts.
`update_website`	Renames a website or connects it to a domain.
`create_website_page`	Creates one page by its slot: Homepage, Services, About, Contact, Extra, Privacy, or Terms.
`update_website_page`	Replaces a page's HTML. On a published website the change waits until you publish again.
`delete_website_page`	Removes a page and frees its slot. Asks for your confirmation.
`set_website_layout`	Sets the shared header, footer, menu links, colors, fonts, logo, and search visibility.
`set_website_button`	Sets the main website button's label and its one target: a funnel, a website page, or a URL.
`publish_website`	Puts every page live on the website's domain. Asks for your confirmation.
`unpublish_website`	Takes the whole website offline. Asks for your confirmation.

Funnels, pages, and variants

Tool	What it does
`duplicate_funnel`	Copies a whole funnel, including its settings and lead delivery, as an unpublished draft.
`delete_funnel`	Deletes a funnel and takes its pages offline. Asks for your confirmation.
`delete_page`	Deletes a page and its variants. Pages with real traffic are archived instead. Asks for your confirmation.
`delete_variant`	Deletes a variant. Asks for your confirmation.
`get_template_html`	Reads one template variant's raw HTML without creating a funnel.
`list_variant_versions`	Lists every saved version of a variant and who or what made it.
`get_variant_html_at_time`	Returns the HTML a visitor saw on a variant at a given moment.
`get_variant_history`	Lines up a variant's conversion rate with its edit history.
`list_folders`	Lists a brand's folders for funnels, offers, copy, or creative.
`move_to_folder`	Files items into a folder, creating it if needed, or takes them out.

Test your flow

Tool	What it does
`create_test_link`	Creates a 24-hour test-drive link for the live funnel. Test visits deliver no leads and fire no pixels.
`cleanup_test_data`	Removes test-drive rows from a funnel's stats. It's left out of the list, but it runs when your agent calls it by name (owners and admins).
`send_test_lead`	Sends a sample lead with every form field and UTM field to a webhook destination so you can map it.
`get_page_speed`	Reads the PageSpeed scores and fix list for a funnel's published pages.

Lead magnets and uploads

Tool	What it does
`upload_lead_magnet`	Adds a PDF or HTML lead magnet to the Lead magnets library, hosted on your domain.
`list_lead_magnets`	Lists hosted lead magnets with their URLs and download counts.
`delete_lead_magnet`	Deletes a lead magnet. Its link stops working. Asks for your confirmation.
`start_image_upload`	Starts a direct upload of a local image up to 25 MB.
`finish_image_upload`	Finishes the direct upload and returns the hosted image URL.

Domains and tracking

Tool	What it does
`get_domain`	Returns a domain's status, DNS records, and connected funnels.
`move_domain_to_brand`	Moves a domain to another brand. Serving and tracking don't change.
`update_domain_tracking`	Sets a domain's pixel, conversion, and Tag Manager IDs and tracking options. Access tokens are entered in the dashboard only.
`update_domain_scripts`	Sets the domain's custom scripts for tools granvl doesn't support natively.
`test_tracking_pixel`	Sends a test conversion through the domain's server-side connections and reports what each platform answered.
`set_domain_crm_stages`	Maps your CRM's pipeline stage names to granvl's lead stages for one domain.

Forms and lead delivery

Tool	What it does
`list_leadprosper_campaigns`	Lists the Lead Prosper campaigns, suppliers, and fields your connected key can see.
`set_leadprosper_destination`	Connects a funnel to a Lead Prosper campaign with a field map.
`set_leaddistro_destination`	Connects a funnel to a Lead Distro AI campaign and source.
`update_form_destination`	Turns a destination on or off, renames it, or changes its order.
`delete_form_destination`	Removes one destination from a funnel. Asks for your confirmation.
`set_sms_verification`	Turns SMS phone verification on or off for a funnel.
`set_funnel_form_fields`	Declares the funnel's form fields and their options.
`get_form_submissions_count`	Counts submissions on granvl's fallback handler. Never returns their contents.

Lead quality

Tool	What it does
`set_qualification_rule`	Defines which answers make a lead qualified on a funnel.
`get_qualification_rule`	Reads the funnel's rule and its counts.
`set_qualification_settings`	Chooses whether unqualified leads show in stats and are sent to ad platforms.
`mark_lead_qualified`	Marks one lead as qualified or sets its CRM stage by hand.
`get_qualify_webhook_url`	Returns the URL your CRM posts stage changes back to.

Analytics and activity

Tool	What it does
`get_workspace_stats`	Rolls up results across every funnel, by funnel or by ad platform.
`get_analytics_events`	Returns raw events for debugging a session. Never includes form values.
`list_session_journeys`	Lists visits with the path taken, the outcome, and the traffic source.
`get_cohort_comparison`	Compares variants within audience cohorts, such as mobile paid Meta traffic.
`list_insights`	Lists performance signals, such as mobile gaps and variants worth scaling.
`get_activity_log`	Shows recent agent activity: which tools ran and what they returned.

Ad reporting

These read granvl's synced ad data, so they need a connected ad account to return anything.

Tool	What it does
`get_ad_data_status`	Explains why an ad read came back empty: last sync, failures, or a missing connection.
`get_ad_to_lander_performance`	Shows which landing page variants convert each ad's traffic best.
`get_ad_breakdowns`	Breaks ad results down by audience segment, such as age, placement, or device.
`record_external_conversion`	Reports an off-platform sale or booked call back to granvl and the funnel's ad platforms.
`campaign_preflight`	Runs the launch checklist before a paid campaign is built: account, budget, landing page, tracking, keywords.

Team

Tool	What it does
`list_team_members`	Lists workspace members, their roles, and pending invitations.
`set_team_member_role`	Changes a member's role. Owners and admins only.

Ad-platform tools (listed once an ad account is connected)

Connect accounts under Settings > Meta Ads and Settings > Google Ads. See Connect ad accounts.

Meta Ads

Tool	What it does
`create_meta_campaign`	Creates an empty, paused Meta campaign.
`create_meta_adset`	Creates a paused ad set with budget, targeting, and placements.
`create_meta_ad`	Creates paused ads from your creatives under the account's Page.
`list_custom_audiences`	Lists the ad account's custom and lookalike audiences.
`search_ad_interests`	Searches Meta's interest targeting by keyword.
`search_meta_locations`	Finds Meta location keys for provinces, states, and cities.
`list_ad_pixels`	Lists the ad account's pixels for conversion-optimized ad sets.
`list_meta_pages`	Lists the Facebook Pages and Instagram accounts your ads can run under.
`set_ad_identity`	Sets the Facebook Page and Instagram account an ad account's ads run under.
`attach_creatives_to_campaign`	Attaches uploaded creatives to a Meta campaign.

Google Ads: Search

Tool	What it does
`create_google_search_campaign`	Creates a paused Search campaign with budget, location, and bidding.
`create_google_ad_group`	Creates an ad group with its keywords.
`create_google_search_ad`	Creates a responsive search ad with a full set of headlines and descriptions.
`update_google_campaign`	Changes bidding or pauses a campaign. Budget changes wait for a person's approval.
`add_google_keywords`	Adds keywords to an ad group.
`add_google_negative_keywords`	Adds negative keywords to a campaign or ad group.
`search_google_locations`	Finds Google location IDs for provinces, states, and cities.
`set_google_location_targeting`	Adds locations or exclusions to an existing campaign.
`list_google_campaigns`	Lists the account's campaigns live from Google, to recover IDs.
`list_google_ad_groups`	Lists a campaign's ad groups live from Google.
`generate_keyword_ideas`	Gets keyword ideas, volume, and suggested bids from Google's Keyword Planner.
`get_google_conversion_actions`	Lists the account's conversion actions and whether each one counts granvl leads.

Google Ads: Demand Gen and audiences

Tool	What it does
`create_google_demand_gen_campaign`	Creates a paused Demand Gen campaign.
`create_google_demand_gen_ad_group`	Creates a Demand Gen ad group for one audience theme.
`create_google_demand_gen_ad`	Creates an image Demand Gen ad from your creatives.
`create_google_demand_gen_video_ad`	Creates a video Demand Gen ad from YouTube-hosted videos.
`create_google_custom_segment`	Creates a custom segment of people who searched given terms.
`list_google_audiences`	Lists the segments and remarketing lists you can attach.
`attach_google_audiences`	Attaches audiences to an existing Search or Demand Gen ad group.

Google Ads: reporting

These read granvl's synced copy of your account, not Google directly.

Tool	What it does
`get_google_keywords`	Returns per-keyword performance.
`get_keyword_history`	Returns daily history for a keyword or the whole account.
`get_search_term_trends`	Returns search-term history, for finding negatives.
`get_impression_share_history`	Shows whether campaigns are limited by budget or by ad rank.
`get_google_negative_keywords`	Lists current negative keywords.

Creatives and drafts

Tool	What it does
`upload_ad_creative`	Uploads an image or video to the workspace's creative library as-is.
`start_creative_upload`	Starts a direct upload of a large local creative file.
`finish_creative_upload`	Finishes the direct upload and adds the file to the creative library.
`list_ad_creatives`	Lists your uploaded creatives and storage use.
`get_creative_performance`	Shows spend, click-through, and cost per lead for each creative across every ad that used it.
`save_campaign_draft`	Saves an in-progress Meta or Google campaign build in granvl. Nothing is sent to the ad platform.
`list_campaign_drafts`	Lists saved campaign drafts.
`get_campaign_draft`	Reloads one saved draft.
`delete_campaign_draft`	Deletes a saved draft. Asks for your confirmation.

Comparisons

Tool	What it does
`compare_ad_sets`	Compares two ad sets and names the layer (CPM, click-through, or conversion rate) behind the gap.
`get_ad_health`	Scores every ad set, ad, and campaign against the rest of your own account and flags fatigue.

granvl MCP tool reference