MCP tool reference

The granvl MCP server exposes the tools below. Names are stable; your agent discovers schemas automatically after connecting. This page is the human-readable map.

Tools are safe by default: HTML is schema-validated on write, ad entities always arrive paused, Ad Guardrails apply to agent actions and can’t be changed by an agent, and every mutation lands in the activity log.

Strategy & copy

Tool	What it does
`get_strategy_brief`	One bounded product + ICP + angle brief with linked evidence and explicit gaps
`get_copy_brief`	The same brief plus existing copy lines and the exact copy gaps for an ad or page
`list_copy_lines`	Read the copy library, filtered by kind, surface, status, angle, or ICP
`create_copy_lines`	Save a batch of new lines, each with a rationale. Lines save as `testing`
`update_copy_line`	Edit one line, or archive it

Products, ICPs, angles, and research are authored in the dashboard, by you or by granvl’s built-in agent. MCP agents read them through the brief tools. See Strategy.

Funnels & pages

Tool	What it does
`create_funnel` / `update_funnel` / `delete_funnel` / `duplicate_funnel`	Manage funnels
`list_funnels` / `get_funnel` / `get_funnel_summary`	Read funnel structure and status
`create_page` / `update_page` / `delete_page` / `list_pages`	Manage pages within a funnel
`get_page_scaffold`	The canonical, contract-perfect skeleton for a page type. Called before authoring any variant HTML
`create_funnel_from_template` / `list_templates` / `get_template` / `get_template_html`	Start from a proven layout
`publish_funnel` / `unpublish_funnel`	Go live or take down
`create_preview_link`	Shareable preview of a work-in-progress page
`create_test_link` / `cleanup_test_data`	Walk the live flow without delivering leads or firing pixels, then clear the test rows
`upload_lead_magnet` / `list_lead_magnets`	Hosted PDFs served from the funnel’s own domain
`get_page_speed`	Lighthouse score and opportunities for published pages

Variants & testing

Tool	What it does
`create_variant` / `update_variant` / `delete_variant` / `duplicate_variant`	Manage page variants (HTML validated on write)
`bulk_create_variants`	Generate several variants in one call
`patch_variant_html`	Exact find-and-replace on part of a page, leaving the rest byte-identical. Preferred over `update_variant` for any scoped edit
`set_weights`	Set the traffic split across a page’s variants
`get_variant` / `get_variant_html` / `get_variant_stats` / `get_variant_history` / `list_variant_versions`	Inspect a variant, its content, performance, and edit history
`get_variant_html_at_time`	The HTML a visitor actually saw at a given timestamp
`list_optimization_actions`	What the autonomous optimizer did: what it paused, flagged, or generated
`save_learning` / `list_learnings` / `get_research_history`	Record and read test conclusions so experiments never repeat a dead end
`list_insights`	Performance signals from the rules engine: mobile gaps, scale-this-variant, channel-mix opportunities

Analytics

Tool	What it does
`get_funnel_stats` / `get_funnel_timeseries` / `get_step_funnel`	Core performance: totals, daily series, step drop-off
`get_segmented_stats` / `get_cohort_comparison`	Slice by source, device, headline type, or cohort
`list_session_journeys` / `get_analytics_events`	Session-level paths and raw events (zero-PII projection: never form values)
`analyze_funnel` / `get_funnel_analysis` / `get_optimization_suggestions`	The copilot’s read: what to do next, with evidence
`get_workspace_stats` / `get_daily_brief`	Workspace roll-ups
`get_activity_log`	Everything that happened, by whom, human and agent alike

Forms & qualification

Tool	What it does
`set_form_destination` / `get_form_destinations`	Wire form submissions to your stack
`send_test_lead`	Fire a synthetic lead (every field from every variant) at a webhook destination so GHL, Zapier, and webhooks can be mapped and verified
`set_funnel_form_fields` / `get_form_submissions_count`	Form structure and counts, never contents
`set_sms_verification`	Require a verified phone before a lead goes through
`set_qualification_rule` / `get_qualification_rule` / `mark_lead_qualified`	What counts as a qualified lead
`set_qualification_settings`	Whether unqualified leads show in stats and fire to ad platforms
`get_qualify_webhook_url`	The CRM webhook that closes the loop with deal values

Campaign hubs

Tool	What it does
`create_campaign_hub` / `update_campaign_hub` / `delete_campaign_hub`	Manage the cross-platform grouping layer. Link edits are add/remove, never replace
`get_campaign_hub` / `list_campaign_hubs`	One hub in full with its measurement roll-up, or the list

Ads: reading & diagnosing

Tool	What it does
`record_ad_entities` / `record_ad_spend`	Push campaign structure and spend from an ads MCP. Idempotent, so re-syncing overwrites rather than double-counting
`get_spend_summary` / `get_ad_breakdowns` / `get_ad_entities`	Spend joined to first-party outcomes
`get_ad_health` / `get_tracking_health`	Per-entity tracking verdicts and the fix for each
`get_ad_data_status`	Why an ads read came back empty: staleness, a failed sync, a missing connection, or an empty warehouse
`get_ad_to_lander_performance` / `get_creative_performance`	Which ads convert, and which lander variants convert their traffic
`compare_ad_sets`	Head-to-head of two ad sets, naming the layer (CPM, click-through, or conversion rate) that drives the gap
`get_google_keywords` / `get_microsoft_keywords` / `get_keyword_history`	Per-keyword performance, live and historical
`get_google_search_terms` / `get_microsoft_search_terms` / `get_search_term_trends`	What people actually typed. The raw material for negatives
`get_google_impression_share` / `get_impression_share_history`	Whether you’re capped by budget or by ad rank
`get_google_conversion_actions` / `get_microsoft_conversion_goals`	Whether the platform is actually counting granvl leads
`get_google_negative_keywords` / `get_microsoft_campaign_settings`	Current negatives and campaign configuration
`get_product_performance` / `record_external_conversion`	Echo off-platform sales (Shopify, Stripe) back in for revenue and ROAS

Ads: building

Meta is the live channel. The Google and Microsoft tools below are built and will work when those channels open; see Ads. record_ad_entities and record_ad_spend are platform-agnostic and work today for any platform.

Tool	What it does
`create_meta_campaign` / `create_meta_adset` / `create_meta_ad`	Meta entities (arrive paused)
`create_google_search_campaign` / `create_google_ad_group` / `create_google_search_ad`	Google Search
`create_google_demand_gen_campaign` / `create_google_demand_gen_ad_group` / `create_google_demand_gen_ad` / `create_google_demand_gen_video_ad`	Google Demand Gen (image and video)
`create_microsoft_search_campaign` / `create_microsoft_ad_group` / `create_microsoft_search_ad`	Microsoft (Bing) Search
`update_google_campaign` / `update_microsoft_campaign`	Bidding strategy and pause. Budget edits are locked server-side during alpha
`add_google_keywords` / `add_google_negative_keywords` / `add_microsoft_keywords` / `add_microsoft_negative_keywords`	Keyword management
`generate_keyword_ideas` / `generate_microsoft_keyword_ideas`	Real volume, competition, and suggested-bid data before choosing keywords
`attach_google_audiences` / `create_google_custom_segment` / `list_google_audiences`	Google audiences and custom segments
`search_ad_interests` / `list_custom_audiences`	Meta targeting research
`search_microsoft_locations` / `set_microsoft_location_targeting`	Microsoft geo targeting and exclusions
`search_linkedin_companies` / `list_linkedin_profiles` / `set_microsoft_linkedin_targeting`	LinkedIn company, industry, and job-function bid boosts on Microsoft Search
`list_meta_pages` / `set_ad_identity` / `list_ad_pixels`	The Facebook Page ads run under, and the pixel to optimize toward
`upload_ad_creative` / `list_ad_creatives` / `attach_creatives_to_campaign`	Creative management
`save_campaign_draft` / `get_campaign_draft` / `list_campaign_drafts` / `delete_campaign_draft`	Draft, resume, and hand off campaign builds between agent and human

Domains, brand & workspace

Tool	What it does
`create_domain` / `get_domain` / `list_domains` / `verify_domain` / `get_domain_dns_records`	Domain lifecycle
`update_domain_tracking` / `test_tracking_pixel`	Per-domain tracking config and verification
`get_brand_kit` / `update_brand_kit`	Brand tokens, logo, voice, and extraction screenshots
`upload_image`	Upload an image by URL or small base64 payload
`start_image_upload` / `finish_image_upload`	Direct upload for local files up to 25 MB, with the bytes never passing through the agent’s context
`get_skill`	The agent’s self-update channel for the granvl skill

What isn’t exposed

Some things are deliberately dashboard-only, because an agent that could change them could remove its own constraints:

Ad Guardrails: the workspace max daily budget and per-account spend and raise caps
Activating an ad campaign: everything granvl builds arrives paused, and going live is your click in the platform’s own ads manager
Promoting a copy line to winner: only warehouse-backed experiment results do that
Strategy records: products, ICPs, angles, and research are authored in the dashboard; MCP agents read briefs and report gaps

Getting started

Concepts

Guides

Reference

Updates

MCP tool reference

Strategy & copy

Funnels & pages

Variants & testing

Analytics

Forms & qualification

Campaign hubs

Ads: reading & diagnosing

Ads: building

Domains, brand & workspace

What isn’t exposed

​Strategy & copy

​Funnels & pages

​Variants & testing

​Analytics

​Forms & qualification

​Campaign hubs

​Ads: reading & diagnosing

​Ads: building

​Domains, brand & workspace

​What isn’t exposed

Strategy & copy

Funnels & pages

Variants & testing

Analytics

Forms & qualification

Campaign hubs

Ads: reading & diagnosing

Ads: building

Domains, brand & workspace

What isn’t exposed