Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.scrunch.com/llms.txt

Use this file to discover all available pages before exploring further.

Scrunch’s MCP connection gives your AI assistant access to 22 features across 7 categories. These are called automatically in response to natural-language prompts — you never need to reference them by name. The descriptions and example prompts below show what each one does and how to ask for it.

​
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.
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.”
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?”
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.”
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?”

​
Brands

Look up and manage the brands tracked in your Scrunch organization.
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?”
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.”
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.
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.”
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.”
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.”
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.”

​
Prompts

Browse and manage the seed prompts Scrunch runs against AI platforms on your behalf.
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.”
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.”
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.”
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.”

​
Tags

Read and update the tags attached to prompts so you can slice metrics by funnel stage, persona, campaign, or any custom dimension.
Returns all tags currently configured for a brand.Example prompts
  • “What tags do we use for Acme Coffee?”
  • “Show me the full tag list across all our brands.”
Sets the full tag list for a single prompt. Anything not in the new list is removed; new tags are created automatically.Example prompts
  • “Tag prompt #482 with ‘consideration’ and ‘mobile’.”
  • “Remove the ‘Q1 campaign’ tag from all prompts and replace it with ‘evergreen’.”

​
Agent traffic

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.
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.”
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.”

​
Utility

Lightweight helpers your assistant uses automatically behind the scenes.
Returns the signed-in user’s email, basic profile, and accessible brands. Your assistant calls this to determine which brands you have access to without asking you to look up a brand ID.Example prompts
  • “What brands do I have access to in Scrunch?”
  • “Which org am I connected to right now?”
Returns the server’s current date in UTC. Your assistant uses this to anchor relative date phrases like “the last 30 days” or “this quarter” before constructing analytics queries. You don’t need to call this directly.