Scrunch MCP Feature Reference and Example Prompts

Scrunch’s MCP connection gives your AI assistant access to 51 features. These are called automatically in response to natural-language prompts — you never need to reference them by name. Related categories are grouped into the tabs below; use them to jump to what you need. Each description and example prompt shows what a feature does and how to ask for it.

Everything for measuring and visualizing AI visibility — the core metrics, plus the Explorer charts and dashboards built on top of them.

Metrics

The four core analytics features. Each accepts the same set of filters: AI platform, country, persona, funnel stage, tags, topics, branded vs. non-branded prompts, and a date range.

get_presence_metrics

Returns brand mention rate (presence) over time — the percentage of AI responses where your brand is mentioned. Set include_competitors=true to compare brands side by side.Example prompts

“How has our presence in ChatGPT trended over the last 90 days?”
“Compare our mention rate vs. all tracked competitors over the past month.”
“Show me weekly presence for our brand on Perplexity since January.”

get_position_metrics

Returns how often the brand appears in the top, middle, or bottom position within AI responses — relative to other brands mentioned in the same response.Example prompts

“Are we showing up first or last when AI assistants list options in our category?”
“What’s our average position on ChatGPT for consideration-stage prompts?”

get_sentiment_metrics

Returns sentiment breakdown (positive, mixed, negative) for brand mentions in AI responses.Example prompts

“What’s the sentiment trend for our brand on Perplexity in the last 30 days?”
“Is sentiment improving or declining compared to last quarter?”
“Compare our sentiment vs. our top competitor across all platforms.”

get_citations_metrics

Returns how AI-cited URLs break down by ownership: brand-owned, competitor-owned, and third-party. Use citation_owner to focus on one type, or brand_mentioned to filter by branded vs. non-branded prompts.Example prompts

“What share of citations come from third-party sites for our non-branded queries?”
“Which competitor’s domains are getting cited the most in our category?”
“How has our owned citation share changed over the last 60 days?”

Explorer

Turn a metric question into an interactive Scrunch Explorer chart or a saved dashboard. Both return a deep link that opens the Explorer pre-configured — great for exploring the data behind an answer or saving a view you’ll revisit.

generate_explorer_chart

Builds an Explorer chart from a metric/breakdown/filter spec and returns a deep link that opens the Explorer with that chart already configured. Your assistant offers this after answering an analysis question so you can explore the chart behind the numbers. Supports line, bar, and pivot visualizations, breakdowns (e.g. by platform or competitor), custom date ranges, and comparison overlays.Example prompts

“Chart our mention rate by AI platform over the last 30 days.”
“Visualize our share of voice vs. our top 3 competitors, weekly.”
“Show citations broken down by owner as a bar chart, and give me the link.”

create_explorer_dashboard

Creates a saved dashboard of metric tiles for a brand and returns a deep link to it. Each tile uses the same spec as generate_explorer_chart plus a title — mix a few headline “card” tiles with line/bar charts for trends and breakdowns.Example prompts

“Build a dashboard for Acme Coffee with presence, sentiment, and citation trends.”
“Create a competitive dashboard comparing our share of voice against Blue Bottle and Stumptown.”

Custom queries

The four metrics features above cover the common questions. When a question needs a combination they don’t offer — an unusual grouping, a filter on a computed value, a period-over-period comparison — your assistant composes a query directly.

query_metrics

Runs an aggregated metrics query against a defined vocabulary of dimensions and metrics. Composed like a SQL GROUP BY: dimensions become group-by columns (date, AI platform, prompt topic, competitor) and metrics become the aggregates. Supports filters, filters on aggregate values, period-over-period comparison, and pagination. Defaults to the last 30 days, and every result reports the resolved date range it actually used.Example prompts

“Break down competitor mention rate by platform and month for Silk.”
“Which prompt topics have a mention rate above 40%, and how many responses back each one?”
“Compare our presence this quarter against last quarter, split by funnel stage.”

get_metric_glossary

Returns exact definitions for every dimension and metric query_metrics accepts — what each measures, its unit or scale, and how similar-sounding fields differ. This is the authoritative source for what a Scrunch metric means, so ask for it whenever a number needs interpreting.Example prompts

“What exactly does presence measure — does a citation of our domain count?”
“What’s the difference between position and share of voice?”
“List every metric I can group by platform.”

Saved patterns

Scrunch ships a curated catalog of query patterns — the same ones behind your dashboard tiles. Your assistant checks these before composing anything from scratch, so answers stay consistent with what the product shows you.

list_query_patterns

Lists the curated query patterns available for a brand: the question each one answers, the metric fields it uses, and a product link that renders it. When a pattern already answers your question, your assistant points you at the product rather than recomputing the number.Example prompts

“What standard reports can you run for this brand?”
“Is there a saved view for citation ownership over time?”

get_query_pattern

Returns the full detail for one pattern: a ready-to-run query template, the product share link, and an Explorer deep link where the pattern maps to one. Used to adapt a pattern to different parameters — another topic, competitor, platform, or date range — instead of composing a new query.Example prompts

“Run the citation-ownership pattern but for the last 7 days.”
“Take the share-of-voice view and swap in our German competitors.”

Pull the raw AI responses Scrunch has captured — full response text, citations, and per-competitor evaluations for individual answers. Use this when you need to read what an AI actually said, not just an aggregate metric.

list_responses

Lists individual AI responses (observations) for a brand. Filter by platform, prompt, persona, funnel stage, date range, and whether the response includes shopping results. Results are paginated with limit (default 10, max 100) and offset.By default it returns observation IDs only, to keep payloads small. Ask for full detail (ids_only=false) to include response text, evaluation data, citations, and competitor analysis for every listed response — or fetch IDs first and pull individual responses with get_response.Use this when you want to audit a specific answer, compare what two platforms said about the same prompt, or pull a sample of recent responses for qualitative review. For aggregated trends, use the metrics features instead.Example prompts

“Show me the 10 most recent ChatGPT responses for Acme Coffee where our brand wasn’t mentioned.”
“Pull every Perplexity response from last week for prompt #482 so I can compare them side by side.”
“Find responses on Google AI Overviews in the comparison stage that include shopping results.”
“Give me the raw responses Claude returned for the ‘sustainability’ persona in April.”

get_response

Fetches a single AI response by ID with full evaluation data, citations, and competitor analysis. Use it to inspect a response ID returned by list_responses.Example prompts

“Pull the full text and citations for response #918273.”
“What did the AI actually say in that response — and which URLs did it cite?”

Manage the seed prompts Scrunch runs against AI platforms on your behalf, their funnel stage and topic classification, and the tags you use to organize them.

Prompts

Browse and manage the seed prompts Scrunch runs against AI platforms on your behalf. list_prompt_templates and list_prompt_variants cover two different grains — templates are the editable seed prompts you configure; variants are the expanded per-platform/persona/geo executions that actually collect data.

list_prompt_templates

Lists the brand’s configured seed prompt templates (active and paused, never archived) with their current stage, topics, and tags — the read side of bulk labeling: call this to find prompt ids and current labels before a write. Filterable by prompt_ids (to verify specific ids rather than paging the whole brand), status (active/paused), stage_id (-1 for no stage), topic_ids (matches ANY of the given topics), text_contains (a literal substring, not semantic search — prefer topic_ids for concept questions), and branded. Set ids_only=true to get every matching id in one unpaginated array, ready to feed straight into a bulk write.Example prompts

“Which of our prompts have no stage assigned yet?”
“Find every active prompt tagged with the ‘pricing’ topic.”
“Give me just the ids of every paused prompt — I’m about to reactivate them.”

list_prompt_variants

Lists the prompt variants Scrunch is monitoring for a brand. Filterable by tag, persona, country, branded vs. non-branded, citation domain, funnel stage, and more.Example prompts

“Show me the top 20 non-branded prompts for Acme Coffee in the US.”
“List all the prompts tagged ‘consideration’ for our brand.”
“Browse the prompts in the awareness stage — I want to see what’s covered before I add new ones.”

create_prompt

Adds a new seed prompt for a brand, optionally with category, key topics, persona, platforms, and tags.Example prompts

“Add a prompt to Acme Coffee: ‘What’s the best mail-order coffee subscription for offices?’ Tag it as ‘consideration’.”
“Create 5 new awareness-stage prompts for Acme Coffee focused on sustainability.”

archive_prompt

Archives (soft-deletes) a seed prompt so it stops running. History is preserved.Example prompts

“Archive prompt #482 — we don’t need to track that one anymore.”
“Archive all prompts tagged ‘Q1 campaign’ for Acme Coffee.”

unarchive_prompt

Restores previously archived prompts so they resume running.Example prompts

“Restore the prompts I archived last month for Acme Coffee.”
“Unarchive all prompts in the ‘seasonal’ tag so they start running again.”

Stages

Read and reassign the customer-journey stage (Awareness, Consideration, Conversion, Loyalty, or a brand’s own customized set) that prompts are classified into.

list_prompt_stages

Lists the brand’s active customer-journey stages — id, name, description, and display order — which may differ from the default set if the brand has renamed or added stages. Use the returned ids/names with update_stage_on_prompts or the stage_id filter on list_prompt_templates.Example prompts

“What funnel stages do we have configured for Acme Coffee?”
“List our journey stages in display order.”

update_stage_on_prompts

Assigns, changes, or clears the customer-journey stage on a batch of prompts in one call — pass stage_id or stage_name (or stage_id=-1 to clear it). This marks the stage as manually assigned, so Scrunch’s automatic classifier stops overwriting it going forward. That’s one-way: clearing a manual stage later does not hand the prompt back to the classifier.Example prompts

“Move prompts #482 and #491 to the Conversion stage.”
“Clear the stage on every prompt in the ‘draft’ tag.”

Topics

Manage the topic taxonomy prompts are classified against — a closed, managed list, unlike the free-form tags below.

list_prompt_topics

Lists the brand’s prompt topics (id, name) along with how many active or paused prompts carry each one. Use the ids/names with add_topics_to_prompts, remove_topics_from_prompts, or the topic_ids filter on list_prompt_templates. This list is the ceiling of what you can assign — topics are never created on the fly by the tools below.Example prompts

“What topics do we have configured for Acme Coffee, and how many prompts use each?”
“Is there already a topic for ‘sustainability,’ or does one need to be created first?”

add_topics_to_prompts

Adds one or more existing topics to a batch of prompts — additive only, a prompt’s existing topics are preserved, and one that already has a given topic is silently skipped. Topics can be given as ids or names (case-insensitive); an unrecognized topic fails the whole call with the valid list rather than creating one. Pass the complete set of prompt ids you matched, not a hand-filtered subset — since already-labeled prompts are simply skipped, there’s no cost to over-including.Example prompts

“Add the ‘sustainability’ and ‘pricing’ topics to every prompt tagged ‘Q2 campaign’.”
“Tag prompts #482 and #491 with the ‘shipping’ topic.”

remove_topics_from_prompts

Removes one or more topics from a batch of prompts. Prompts that don’t carry a given topic are silently ignored, and their other topics are unaffected. Removing a topic from prompts never deletes the topic itself from the brand’s taxonomy.Example prompts

“Remove the ‘seasonal’ topic from every prompt now that the campaign’s over.”
“Take the ‘draft’ topic off prompts #482 and #491.”

Brands

Look up and manage the brands tracked in your Scrunch organization.

list_brands

Lists all brands accessible within the authenticated organization, including name, website, status, and configuration details.Example prompts

“Show me all the brands I have access to in Scrunch.”
“Which brands in our org have the most prompts configured?”

create_brand

Creates a new brand within the organization. Name, website, and status are required.Example prompts

“Create a new Scrunch brand for Acme Coffee, website acmecoffee.com.”
“Set up a new brand for our UK subsidiary — name is Acme Coffee UK, website acmecoffee.co.uk.”

update_brand

Updates an existing brand’s name, alternative names, websites, geo, or case-sensitivity settings.Example prompts

“Add ‘Acme Coffee Co.’ as an alternative name for the Acme Coffee brand.”
“Switch the geo for our Acme brand from US to UK.”

Competitors

Manage the competitors tracked alongside each brand.

list_competitors

Lists all competitors being tracked for a specific brand, including their alternative names and websites.Example prompts

“Who are we tracking as competitors for Acme Coffee?”
“List the competitors for all our brands.”

create_competitor

Adds a new competitor to a brand, with an optional list of alternative names and websites.Example prompts

“Add Blue Bottle as a competitor for Acme Coffee with website bluebottlecoffee.com.”
“Start tracking Stumptown Coffee as a competitor — add their main site and their DTC site.”

update_competitor

Updates an existing competitor’s name, alternative names, or websites.Example prompts

“Add bluebottle.com as an alternative website for the Blue Bottle competitor.”
“Rename the competitor ‘Blue Bottle’ to ‘Blue Bottle Coffee’ for Acme Coffee.”

create_competitors

Creates several competitors in one call — the preferred way to add competitors via MCP, and fine for a single one too. Each item succeeds or fails independently, so one bad entry never sinks the batch. Per-item results come back as created, already_exists (a competitor with that name is already active, and its existing ID is returned), or failed (invalid URL, a website already claimed by another competitor, or a blocked name).Example prompts

“Add Blue Bottle, Stumptown, and Intelligentsia as competitors.”
“Set up these 12 competitors for the new brand from this list.”

archive_competitor

Soft-deletes a competitor from a brand’s tracked list. History is preserved; the competitor just stops appearing in new data.Example prompts

“Stop tracking Blue Bottle as a competitor for Acme Coffee.”
“Remove the three competitors we added last year that are no longer relevant.”

Personas

Manage the personas tracked alongside each brand. Personas represent distinct customer segments (for example, “first-time buyers” or “enterprise IT admins”) and can be attached to prompts so you can slice metrics by audience.

list_personas

Lists all personas configured for a brand, including their names and descriptions.Example prompts

“What personas do we have for Acme Coffee?”
“List the personas across all our brands.”

create_persona

Creates a new persona on a brand. Requires a name and description.Example prompts

“Create a persona called ‘Office manager’ for Acme Coffee — someone responsible for stocking the office kitchen.”
“Add a ‘Home barista’ persona for Acme Coffee focused on enthusiasts who grind their own beans.”

archive_persona

Soft-deletes a persona from a brand. Historical data is preserved; the persona just stops appearing in new prompts and filters.Example prompts

“Archive the ‘Q1 test’ persona on Acme Coffee.”
“Remove the personas we added during the pilot — they’re no longer used.”

update_persona_on_prompts

Assigns, changes, or removes the persona on a batch of prompts in one call. Pass a persona ID to attach it, or omit the persona to clear it.Example prompts

“Assign the ‘Office manager’ persona to all prompts tagged ‘workplace’ for Acme Coffee.”
“Clear the persona on prompts #482, #491, and #503 — they should be persona-agnostic.”

Sub-brands

Sub-brands are the product lines, series, and SKUs beneath a brand — yours or a competitor’s. Tracking them separately lets you see whether AI assistants recommend a specific product rather than just the parent brand. Names are unique across the whole brand, so your own sub-brand and a competitor’s can’t share one.

list_sub_brands

Lists the brand’s own sub-brands, including their tier.Example prompts

“What sub-brands do we track for Acme Coffee?”
“List our product lines and their tiers.”

create_sub_brands

Creates one or more of the brand’s own sub-brands. tier is optional and defaults to product line. Each item is processed independently, returning created, already_exists, failed, or quota_exceeded. A quota_exceeded result means your plan limit was reached — the remaining items are not created, and retrying them won’t help.Example prompts

“Add Cold Brew, Espresso Roast, and Single Origin as sub-brands of Acme Coffee.”
“Set up our four product lines from this spreadsheet.”

list_all_competitor_sub_brands

Lists the sub-brands tracked across all of the brand’s competitors, so you can see how deep competitive coverage goes in one call.Example prompts

“What competitor product lines are we tracking?”
“Which competitors have sub-brands configured and which don’t?”

create_competitor_sub_brands

Creates sub-brands under a competitor. Every item needs the parent competitor’s ID, which your assistant looks up first. Same per-item statuses and plan-limit behavior as create_sub_brands.Example prompts

“Add Blue Bottle’s three main coffee lines as sub-brands.”
“Track Stumptown’s Hair Bender and Holler Mountain blends.”

Bring AI bot crawl logs into Scrunch, or pull them out for analysis elsewhere. Useful for understanding how often GPTBot, ClaudeBot, PerplexityBot, and others are crawling your site.

import_agent_traffic

Ingests agent traffic logs from a CSV. Required columns: domain, user_agent, url, path, method, status_code, timestamp. Bot classification happens automatically on import.Example prompts

“Import this week’s bot traffic CSV for acmecoffee.com.”
“Load the server logs I just exported — here’s the CSV.”

export_agent_traffic

Exports agent traffic data as a CSV. Filterable by date range, site, path, and aggregation level (day or week).Example prompts

“Export the last 30 days of GPTBot traffic to acmecoffee.com.”
“Give me a weekly summary of all AI bot activity on our site in Q1.”

Answer questions about how Scrunch works. Your assistant reaches for the Help Center first, then falls back to Scrunch’s public web content — always citing its sources.

list_scrunch_help_collections

Lists every Scrunch Help Center collection and the articles inside each one. Your assistant uses this to find the article that best matches a support-style question (features, troubleshooting, onboarding, plan/billing UX), then reads it with get_scrunch_help_article.Example prompts

“How do I set up a new brand in Scrunch?”
“What’s the difference between branded and non-branded prompts?”

get_scrunch_help_article

Fetches the full body of a single Help Center article by ID — discovered via list_scrunch_help_collections. The assistant quotes or summarizes the article and cites its URL under a Sources: section.Example prompts

“Walk me through configuring competitors, and cite the help docs.”
“Explain how funnel stages work, with a link to the article.”

search_scrunch_docs

Searches the Scrunch developer documentation at developers.scrunch.com — API endpoints, authentication, SDK and curl examples, webhooks, integrations, and MCP setup. This is the one to reach for on developer and integration questions; metric definitions come from get_metric_glossary instead, which is more precise than docs prose. Returns snippets with page URLs, which your assistant then reads in full with fetch_scrunch_url.Example prompts

“How do I pull presence metrics through the REST API?”
“What’s the curl example for authenticating against the Scrunch API?”
“How do I set up the Looker Studio connector?”

fetch_scrunch_url

Fetches a Scrunch-owned web page and returns its main content as markdown. Used when the Help Center doesn’t cover a question and the answer lives in Scrunch’s public content — product and feature pages on scrunchai.com, or REST/SDK reference on developers.scrunch.com. Only scrunch.com, scrunchai.com, and developers.scrunch.com (and their subdomains) are allowed.Example prompts

“Summarize the Agent Experience Platform product page.”
“What do the developer docs say about API authentication?”

Get Started

Agent Skills

Workflows

Prompt Library

Scrunch MCP Feature Reference and Example Prompts

Metrics

Explorer

Custom queries

Saved patterns

Prompts

Stages

Topics

Tags

Brands

Competitors

Personas

Sub-brands

​Metrics

​Explorer

​Custom queries

​Saved patterns

​Prompts

​Stages

​Topics

​Tags

​Brands

​Competitors

​Personas

​Sub-brands

Metrics

Explorer

Custom queries

Saved patterns

Prompts

Stages

Topics

Tags

Brands

Competitors

Personas

Sub-brands