> ## Documentation Index
> Fetch the complete documentation index at: https://docs.granvl.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP tool reference

> Everything your agent can do in your workspace, grouped by area.

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

## 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 & status               |
| `create_page` / `update_page` / `delete_page` / `list_pages`             | Manage pages within a funnel                 |
| `publish_funnel` / `unpublish_funnel`                                    | Go live / take down                          |
| `create_preview_link`                                                    | Shareable preview of a work-in-progress page |

## 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                         |
| `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 |
| `save_learning` / `list_learnings` / `get_research_history`                                                | Record and read test conclusions so experiments never repeat  |

## 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, cohort                       |
| `list_session_journeys` / `get_analytics_events`                          | Session-level paths and raw events                    |
| `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                                    |

## Forms & qualification

| Tool                                                                        | What it does                                |
| --------------------------------------------------------------------------- | ------------------------------------------- |
| `set_form_destination` / `get_form_destinations`                            | Wire form submissions to your stack         |
| `set_funnel_form_fields` / `get_form_submissions_count`                     | Form structure & counts (never contents)    |
| `set_qualification_rule` / `get_qualification_rule` / `mark_lead_qualified` | In-memory lead qualification + CRM feedback |

## Ads

| Tool                                                                                                      | What it does                                                       |
| --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
| `record_ad_entities` / `record_ad_spend`                                                                  | Push campaign structure + spend from an ads MCP                    |
| `get_spend_summary` / `get_ad_breakdowns` / `get_ad_entities` / `get_ad_health`                           | Spend joined to first-party outcomes; per-entity tracking verdicts |
| `get_ad_to_lander_performance` / `get_creative_performance`                                               | Which ads convert, and which lander variants convert their traffic |
| `create_meta_campaign` / `create_meta_adset` / `create_meta_ad`                                           | Create Meta entities (arrive paused)                               |
| `create_google_search_campaign` / `create_google_search_ad` / `create_google_ad_group`                    | Google Search                                                      |
| `create_google_demand_gen_campaign` / `create_google_demand_gen_ad_group` / `create_google_demand_gen_ad` | Google Demand Gen                                                  |
| `upload_ad_creative` / `list_ad_creatives` / `attach_creatives_to_campaign`                               | Creative management                                                |
| `generate_keyword_ideas` / `search_ad_interests` / `list_custom_audiences`                                | Planning & targeting                                               |
| `save_campaign_draft` / `get_campaign_draft` / `list_campaign_drafts` / `delete_campaign_draft`           | Draft, resume, and hand off campaign builds                        |

## Domains & 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` / `get_tracking_health`                     | Per-domain tracking config & audits                                                 |
| `get_workspace_context` / `update_workspace_context`                                         | The workspace’s standing context (brand, goals) that your agent reads before acting |
| `get_brand_kit` / `update_brand_kit` / `upload_image`                                        | Brand assets                                                                        |
| `get_activity_log`                                                                           | Everything that happened, by whom                                                   |

<Tip>
  Tools are safe-by-default: HTML is schema-validated on write, ad entities arrive paused, spend caps from [Ad Guardrails](/guides/ads#guardrails) apply to agent actions, and every mutation lands in the activity log.
</Tip>