Your Whole Search Picture, One Question Away

Connect Claude, ChatGPT or Cursor to Quattr and ask questions the way you'd ask a colleague. Your assistant runs governed Quattr analyses on your organization's own data: real numbers, never a model's guess, with answers linked back to the app.

Overview

What is the Quattr MCP?

MCP (Model Context Protocol) is an open standard that lets AI assistants securely use external tools. The Quattr MCP server gives your assistant a set of ready-made, trusted Quattr analyses it can run for you. When you ask "How did my clicks trend last month vs the month before?", the assistant picks the right Quattr analysis, runs it against your organization's data (secured by OAuth sign-in with your Quattr account), and answers with real numbers, often as a rich, interactive result card with a link back to the Quattr app.

Read-only by design
The Quattr MCP can only read and analyze your data. It cannot modify your Quattr configuration, segments, or site. Every connection is scoped to read-only access.

Quick start

  1. Have a Quattr account

    Use the same work email you use for www.quattr.com, and make sure you've signed in to the Quattr app at least once.

  2. Add the connector

    In your AI client, add the Quattr MCP server URL https://mcp.quattr.com/mcp and sign in when prompted. Step-by-step per client →

  3. Start asking

    Try: "What were my total organic clicks and impressions for last month?" or browse the prompt library.

What you can ask about

Quattr gives your assistant 58 analysis tools across nine areas. Your question is routed to the right one automatically, so you never need to know tool names.

Search performance (GSC)

Clicks, impressions, CTR and rankings: totals, breakdowns, trends, movers, CTR curves and striking-distance opportunities.

  • "Top 10 keywords by clicks for June."
  • "Which keywords moved the most vs May?"

Market share & competitors

Your share of the market vs tracked competitors, by segment, intent, keyword, page or category, with gains and losses.

  • "How's my market share? Who leads, and what's the gap?"

AI visibility

How often ChatGPT, Perplexity, Gemini and Google AI Mode cite your pages: trends, competitors, prompts and coverage gaps.

  • "Is our AI visibility going up or down over 3 months?"

Paid search

Google Ads spend, CPC, cost per conversion, impression share, and paid/organic keyword overlap.

  • "Are we paying for keywords we already rank for?"

Web analytics & conversions

Sessions, users, engagement, conversions by goal, funnels, and statistical significance of changes (GA4 / Adobe).

  • "How many conversions did we get, broken down by goal?"

Site health (Core Web Vitals)

LCP, INP, CLS and Lighthouse grades: weakest pages, device splits, and traffic-weighted views.

  • "Any Core Web Vitals problems? Which pages are weakest?"

Crawlers & site structure

AI crawler activity (GPTBot, ClaudeBot…), Googlebot verification, crawl-budget waste, orphan pages, indexation gaps.

  • "Are AI crawlers reaching our content?"

Statistics & sanity checks

Is a change real or noise? Do two metrics move together? Rigorous significance tests and cross-domain correlation.

  • "Clicks dropped 20%. Is that real or noise?"

Dashboards & reports

Find and run your existing Quattr dashboards and saved reports from chat.

  • "Preview my executive SEO dashboard."

See the full tool reference →

How results look

In clients that support interactive results (like ChatGPT and Claude), answers render as native Quattr cards. Every card is honest about where its numbers came from:

Search performancegoogle/organic · site
Clicks
Period total
79.54K
Daily average
2.65K
Latest day
3.39K
Jun 30
Peak day
3.65K
Jun 19
3.7K1.8K0
Jun 1Jun 7Jun 13Jun 18Jun 24Jun 30
observationalas of 2026-06-30GSC lags 1–2 dayssource: google/organicOpen in Adhoc Analysis ↗Open in Quattr ↗
Card elementWhat it tells you
Headline takeawayA one-line summary of the key finding, color-coded neutral / positive / caution.
Scope stripChips echoing exactly what produced the numbers: date range, comparison period, organic vs paid, brand filter, device, segment, and any filters. If the numbers look surprising, check the scope first.
observationalThe data is observational: it shows what happened, not what caused it. Correlations are not proof of causation.
Freshness note"as of <date>" plus any known lag (e.g. Search Console data lags 1–2 days).
CaveatsAny honesty notes, e.g. a filter that couldn't be carried into a deep-link, or a modeled estimate.
Open in QuattrDeep-links into the Quattr app with the same view, dates, segment and filters already applied, so you can keep exploring.
Open in Adhoc AnalysisOpens the exact data behind the card in Quattr's Adhoc Analysis view: the precise underlying table, which you can tweak, save, and add to any of your Quattr dashboards.
Text-only clients
Some clients (e.g. Claude Code in the terminal) don't render interactive cards, so you'll get the same numbers as clean text instead. Nothing is lost except the visuals.

Good to know

Your data only

Sign-in binds your session to your organization. Every result is stamped with a company_name label, and the assistant is instructed to stop if it ever doesn't match the company being discussed.

Data freshness

Sources update on different cadences: Search Console lags 1–2 days, web analytics loads nightly, market share and AI visibility ~daily, Core Web Vitals roughly biweekly. Ask "How fresh is my data?" anytime.

Fair-use limits

Up to 60 requests/minute per user and a daily per-account analysis budget (resets midnight UTC). Normal conversational use never hits these.

Honest refusals

If a data source isn't part of your subscription, or a question can't be answered faithfully (e.g. an unsupported metric trend), you get a clear "not available", never a made-up number.

Next steps

Connect your AI client (Claude, ChatGPT, Cursor, Claude Code, VS Code…)
Copy-paste example prompts to see what's possible
Browse all 58 analysis tools
Troubleshooting, security & FAQ

Connect & Settings

Connect the Quattr MCP server to your AI assistant in about two minutes. Setup is the same everywhere: add the server URL, sign in with your Quattr account, start asking questions.

Server endpoint

HTTPS https://mcp.quattr.com/mcp Transport: Streamable HTTP (remote) · Authentication: OAuth 2.1 with your Quattr account · Access: read-only

Before you connect

RequirementDetails
A Quattr accountSign in with the same work email you use for www.quattr.com. You must have signed in to the Quattr app at least once before connecting. A brand-new email that has never logged in will be rejected at sign-in.
MCP access for your organizationMCP access is enabled per organization by Quattr. If sign-in is refused for your whole team, contact your Quattr customer success manager.
A supported AI clientQuattr approves each AI client explicitly for security. Currently approved: Claude (claude.ai web & desktop), Claude Code, ChatGPT, Cursor, and VS Code. Using something else? See Other MCP clients.

Connect your AI client

Click your client for step-by-step setup.

Claude (claude.ai web & Claude Desktop)Open Connectors ↗
  1. Open claude.ai or the Claude desktop app.
  2. Go to Settings → Connectors → Add custom connector.
  3. Configure the connector:
    Name: Quattr Analytics
    URL: https://mcp.quattr.com/mcp
  4. Click Add, then Connect. A Quattr sign-in window opens. Sign in with your Quattr (www.quattr.com) credentials.
  5. In a new chat, make sure the Quattr connector is enabled in the tools menu, then start asking questions about your data.
  6. Verify it works: ask "What data sources are connected for my site?". A real answer about your site confirms you're connected and seeing your company's data.

Note: custom connectors require a Claude plan that supports them; on Team/Enterprise plans an admin may need to enable the connector for the workspace.

Claude Code (CLI)

Setup: run the command below in your terminal, then authenticate inside Claude Code.

  1. Add the Quattr MCP server (user scope makes it available in every project):
    claude mcp add --transport http --scope user quattr https://mcp.quattr.com/mcp
  2. Start Claude Code:
    claude
  3. Authenticate with Quattr:
    /mcp
    Select quattr and follow the browser sign-in flow.
  4. Verify it works: ask "What data sources are connected for my site?"

Note: Claude Code shows results as clean text rather than interactive cards; the numbers are identical.

ChatGPTOpen ChatGPT ↗

MCP connectors in ChatGPT are added via developer mode (availability depends on your ChatGPT plan and workspace settings).

  1. Open chatgpt.com or the ChatGPT desktop app.
  2. Go to Settings → Apps & Connectors → Advanced settings and enable Developer mode.
  3. Back under Apps & Connectors, choose Create (new connector) and enter:
    Name: Quattr Analytics
    MCP server URL: https://mcp.quattr.com/mcp
    Authentication: OAuth
  4. Click Connect and complete the Quattr sign-in when prompted.
  5. In a chat, add the Quattr connector from the tools menu (Developer mode), then start asking.

Tip: for best results, create a dedicated ChatGPT project for Quattr analytics and add instructions like:

When using the Quattr MCP: always state the date range you analyzed; use
the tools to discover segments, trackers and filter values rather than
asking me; prefer the analysis the find_relevant_analysis tool routes to;
check the company_name on results matches my company; and include the
Open in Quattr link when a result card provides one.
CursorAdd to Cursor

Quick install: click Add to Cursor on this row (requires Cursor installed), then authenticate. Or set up manually:

  1. Open Cursor → Settings… → Cursor Settings → Tools & Integrations → New MCP Server.
  2. Add this to your mcp.json:
    {
      "mcpServers": {
        "quattr": {
          "url": "https://mcp.quattr.com/mcp",
          "transport": "streamable-http"
        }
      }
    }
  3. Return to Tools & Integrations and click the authenticate prompt next to quattr; sign in with your Quattr credentials.
  4. Ask questions in chat; Cursor will call Quattr tools automatically. Verify: "What data sources are connected for my site?"

If tool calls start failing later, run "Clear All MCP Tokens" from the Command Palette and re-authenticate.

VS Code (GitHub Copilot)Add to VS Code

Quick install: click Add to VS Code on this row, approve the browser's "Open Visual Studio Code" prompt, then authenticate. Or set up manually:

  1. Run the command MCP: Add Server… from the Command Palette (or edit mcp.json) and choose HTTP.
  2. Use this configuration:
    {
      "servers": {
        "quattr": {
          "type": "http",
          "url": "https://mcp.quattr.com/mcp"
        }
      }
    }
  3. When VS Code prompts to authenticate, complete the Quattr sign-in in your browser.
  4. Use Copilot Chat in Agent mode; Quattr tools appear in the tools picker.
+ Other MCP clients

Any MCP-compatible client that supports remote Streamable HTTP servers with OAuth can technically speak to Quattr, but for security, Quattr only admits clients that have been explicitly approved (allowlisted) for the service. If your client shows an authorization error like "this client is not permitted", it isn't on the approved list yet.

To request approval for a new client, contact your Quattr customer success manager with the client's name and its OAuth client metadata URL (CIMD), if it has one.

How sign-in works

OAuth 2.1, no API keys

You never paste keys or passwords into the AI client. The client redirects you to Quattr's secure sign-in; after you approve, it receives short-lived, signed access tokens that refresh automatically.

Read-only scope

Tokens carry the quattr:read scope only. The MCP can analyze your data but can never change your Quattr configuration or write anything.

Your permissions, no more

The MCP inherits your existing Quattr account's access: your verified sign-in email maps to your Quattr user, which determines the organization and data every answer comes from. Connecting grants no additional access beyond what your account already has.

Sessions

Connections stay valid for extended periods and survive Quattr deployments. An idle session expires after 7 days, after which the client reconnects transparently or asks you to re-authenticate.

Which company's data am I seeing?

Each conversation is bound to exactly one organization: the one your Quattr account is currently associated with.

  • Every result, including errors, carries a company_name label naming the customer the data belongs to. The assistant is instructed to stop and tell you if it doesn't match the company you're asking about.
  • If you have access to multiple Quattr customers and switch in the Quattr app, start a new conversation (or disconnect/reconnect the connector). Existing conversations stay pinned to the customer they started with, and you'll see a "tenant changed" message if a stale session is used.

Settings that shape your answers

The MCP resolves the business objects your team has configured in Quattr, by name, so you can just say them in chat. Manage these in the Quattr app; the MCP picks up changes automatically (within ~24 hours, or immediately in a new session).

ObjectWhat it does in chatExample
SegmentsScope market-share and ranking analyses to a tracked keyword set. The primary "Overall Market" (default) segment covers your whole domain."market share in my Hosting segment"
AI visibility trackersScope AI-answer citation metrics (ChatGPT, Perplexity, Gemini, AI Mode) to a tracked prompt set."AI visibility on my Brand tracker"
GoalsConversion breakdowns use your own GA goal names."conversions by goal: how many Purchases?"
Competitor setsCompetitive comparisons run against the competitors tracked per segment."compare us to Hostinger and GoDaddy"
Intents (keyword groups) & categoriesFilter or break down almost any analysis by your configured keyword groups and content categories."clicks for my Informational intent"

Data sources & what they unlock

Tool availability follows your Quattr subscription and connected data feeds. If a source isn't connected, related questions get an honest "not available" instead of a wrong number. Ask "What data sources are connected for my site, and how fresh is each one?" anytime.

Data sourceUnlocksTypical freshness
Google Search ConsoleSearch performance: clicks, impressions, CTR, position, movers, CTR curve, striking distanceLags 1–2 days
GSC via BigQuery (optional)Far more granular per-query data; used only when you explicitly ask for the BigQuery source and your account has the feedLags 1–2 days
Market shareShare vs competitors, competitive rankings, keyword gaps, featured snippets, Google AI Overviews inclusion, AEO prompt attribution~Daily
AI visibilityChatGPT / Perplexity / Gemini / AI Mode citation metrics, trends, competitor share of voice~Daily
Web analytics (GA4 / Adobe)Sessions, users, engagement, conversions, funnels, significance testsNightly
Google AdsSpend, CPC, cost per conversion, impression share, paid/organic overlap~Daily
Lighthouse / page experienceCore Web Vitals grades, weakest pages, traffic × LCP joins~Biweekly (varies by account)
Site crawl feedOrphan pages, internal link flow, indexation gaps, crawl-budget wastePer crawl schedule
Server web logsAI crawler activity, Googlebot verificationHours – nightly

Usage limits

Limits keep Quattr analytics fast for everyone. Normal conversational use won't hit them.

LimitValueWhen exceeded
Requests per user60 / minute"Too many requests; retry in N seconds"
Daily analysis budget per account500 analysis queries or 60 minutes of query time / day"Budget exhausted; resets at midnight UTC"
Concurrent heavy queries per user2Brief "overloaded" backpressure; the assistant retries
Longest single queryUp to ~10 minutesVery heavy questions may take a while; the connection stays alive

For administrators

Access control

MCP access is enabled per organization by Quattr, and each AI client is individually approved before it can complete sign-in. Contact Quattr to enable access for your team or approve an additional client.

Data protection

OAuth 2.1 with PKCE; short-lived signed access tokens with rotating refresh tokens; strict per-organization isolation enforced at the data layer on every query; read-only scope.

Auditability

Tool calls are audit-logged server-side (durably shipped to secure storage), so usage is traceable per user and organization.

AI client processing

The AI assistant you connect (e.g. Claude or ChatGPT) processes the query results to write its answers. Review your organization's policies on AI-assisted data analysis before rolling out broadly.

After a Quattr-side update
If tools seem missing or behave oddly right after a new Quattr release, refresh/reconnect the connector and start a new conversation. Clients cache tool definitions per session.

Tool Reference

The Quattr MCP exposes 58 tools. You never call them by name. Just ask a question and the assistant picks the right tool automatically. This reference helps you understand what's possible and why an answer was scoped the way it was.

Read-only · your organization only
All analyses are read-only and scoped to your organization. Tools that need a data source you don't have (e.g. Google Ads, site crawl) return an honest "not available" instead of a number. Want to try one? Grab a ready-made question from the Example Prompts section.

Ask & discover 5 tools

How the assistant finds the right analysis, entities and filter values.

ToolWhat it doesNotes
find_relevant_analysisRoutes any analytics question to the authoritative Quattr analysis.Called first for every question.
resolve_entityResolves the names you use (segments, AI trackers, goals, competitor sets, AI platforms) to the exact object.Say "my Hosting segment" and it resolves automatically.
list_filter_valuesLists the valid values (and operators) for a filter: country, intent, category, device, brand, rank bucket, page, query…Prevents guessed filter values.
describe_data_sourcesWhich data sources your account has, each with its latest data date and load cadence.Great first question after connecting.
get_data_freshnessLatest available data date per domain (search, analytics, market share, AI visibility, ads, page experience).Use when numbers look stale.

Search performance (Google Search Console) 8 tools

Your clicks, impressions, CTR and average position. Defaults to organic.

ToolWhat it answersNotes
search_performanceTotals or top keywords/pages for one period: clicks, impressions, CTR, position, unique keyword/page counts; optional trend or period comparison."Total clicks last month", "top 10 keywords".
gsc_breakdownOne period broken down by page, country, device, category, intent, query, rank bucket, traffic source, language or geo.Snapshot only (no time series).
gsc_dimensional_trendA day/week/month/quarter series by one of those drill fields, e.g. weekly clicks by page.Multi-metric series (any mix of clicks, impressions and CTR in one call).
seo_ranking_movement_reportBiggest gainers and losers in clicks, impressions or position between two periods."What changed vs last month?"
ctr_curve_modelYour site's own CTR-by-position curve, plus queries over/under-performing their expected CTR.Segmented branded vs non-branded.
striking_distanceKeywords just off page 1 (positions 8–20) ranked by modeled click upside if nudged up.Modeled estimate with an AI-Overview haircut, not a promise.
compare_periodsWhole-site period-over-period deltas for a summarized result.For site-level comparisons.
run_looker_queryAdvanced escape hatch: query a dataset by explicit fields/filters/sorts.Used only when no standard analysis fits.

Market share & competitive 9 tools

You vs your tracked competitors. Share values are percentages on a 0–100 scale; analyses default to your primary "Overall Market" segment unless you name one.

ToolWhat it answersNotes
market_share_overviewYour share vs competitors, the segment leader, and the gap, sliceable by intent, category, page or brandedness.Share only; pair with clicks via growth_vs_market_share.
growth_vs_market_shareMarket share side-by-side with one of your own metrics (clicks, impressions, CTR, position)."Are we growing faster than our share?"
market_share_breakdownShare ranked across intents, keywords, pages, categories, brandedness, rank buckets or countries, incl. biggest gains/losses.The multi-row market-share view.
market_share_queryShare for you plus several named competitors in one table."Us vs Hostinger vs GoDaddy."
competitive_keyword_rankingPer-keyword average rank position for you and competitors.Ranking (1 = top), not share.
competitive_overviewSnapshot of one competitive metric vs rivals: featured snippets, Google AI Overviews inclusion, brand mentions, ranked keywords/pages.Google on-SERP AI Overviews, not ChatGPT citations.
competitive_trendsThe same competitive metrics as a time series (plus market share and average rank).Segment-level.
total_search_shareOrganic share + paid impression share combined into one total-SERP share.A labeled estimate; SERP geometry is approximated.
seo_keyword_gap_analysisKeywords where competitors beat you: losing / winning / not-ranked buckets with gap sizes.Per segment.

AI visibility (ChatGPT · Perplexity · Gemini · AI Mode) 8 tools

How AI answer engines cite you. Distinct from Google's on-SERP AI Overviews (see competitive tools above). Most views are scoped to an AI visibility tracker.

ToolWhat it answersNotes
ai_visibility_overviewYour AI-answer scorecard: citation rate, share of voice, mentions, sentiment per platform.Whole-account or per tracker.
ai_visibility_trendCitations / share of voice / sentiment over time."Going up or down?"
ai_visibility_competitorsWhich competitors lead you on AI visibility, ranked.Per tracker.
ai_visibility_citation_auditCurrent citation counts and rate for a period."Are our citations dropping?"
ai_visibility_drilldownFull drilldown by tab: competitors, prompts, cited URLs, intent, geography, branded.Mirrors the Quattr app view.
ai_citation_attributionWhich prompts cite your pages the most.Where you win AI answers.
ai_page_citationsWhich of your pages (or a competitor's) get cited, how often, and at what position.Blog vs comparison vs docs categories.
ai_prompt_coverage_gapPrompts where you're missing or under-cited: your coverage gaps.Useful for content planning.

Paid search (Google Ads) 3 tools

ToolWhat it answersNotes
paid_search_overviewSpend, CPC, cost per conversion, conversions: total, trended, or ranked by keyword/campaign/ad group/page.Whole-domain.
paid_impression_shareSearch / top / absolute-top impression share and share lost to rank.Auction coverage, per segment.
paid_organic_overlapKeywords you pay for while already ranking organically (top-3 flagged).Observational, not proof of cannibalization.

Web analytics & conversions (GA4 / Adobe) 4 tools

ToolWhat it answersNotes
web_analytics_overviewSessions, users, conversions, conversion rate, bounce, engagement, filtered or broken down by country, device, page, source, category, intent.The behavioral, on-site lens.
conversions_overviewConversion counts by your own goal names (Purchase, Sign-up…), plus transactions, revenue, conversion rate.Uses your configured GA goals.
funnel_dropoffWhere users drop between funnel steps (e.g. sessions → conversions → transactions) and the biggest leak.Macro-funnel over count metrics.
pop_significanceWhether a conversion-rate or traffic change is statistically real or noise.Proper z-test / t-test with a verdict.

Site health (Core Web Vitals) 2 tools

ToolWhat it answersNotes
site_health_cwv_checkLCP / INP / CLS / performance grades, distributions, weakest pages, device splits, trends, Lighthouse scores.CWV data typically refreshes ~biweekly.
page_traffic_cwvYour highest-traffic pages joined with their LCP: which busy pages are slow.Observational join, top-N pages.

Crawlers & site structure 6 tools

From your server logs and Quattr's site crawl. Requires the corresponding feed.

ToolWhat it answersNotes
ai_crawler_analysisHow AI crawlers (GPTBot, ChatGPT-User, PerplexityBot, ClaudeBot, Google-Extended…) hit your site.Server-log activity, not citations.
bot_verificationWhich "Googlebots" are real vs spoofed, via IP verification.Web-logs feed.
crawl_budget_wasteDeep, parameterized or non-200 URLs eating crawl budget.Site-crawl feed.
indexation_gap_diagnosisPages blocked from indexing and why (noindex, canonical, robots, status).Site-crawl feed.
orphan_pagesPages no internal link points to.Site-crawl feed.
internal_link_flowIncoming/outgoing internal-link counts per page; under-linked important pages.Site-crawl feed.

Statistics 2 tools

ToolWhat it answersNotes
significance_checkIs a period-over-period change real or noise? Delta, p-value and a plain verdict.Works across search, share, analytics, paid, CWV.
correlate_domainsDo two metrics from different areas move together? Pearson/Spearman with significance.Correlation is not causation, and it says so.

Dashboards & saved reports 5 tools

ToolWhat it answersNotes
find_relevant_contentThe dashboards/saved reports most relevant to a question.Prefers a standard analysis when one answers the question.
list_dashboardsYour dashboards, most-used first.
run_dashboardChat-native dashboard: recommend, preview (runs tiles), or describe.Includes a deep-link to the full dashboard.
run_dashboard_tileRuns a single tile, optionally with overridden filters/dates.
run_lookRuns a saved report by ID.

Results & utilities 6 tools

ToolWhat it answersNotes
render_analysisRenders a synthesis of prior results as a native Quattr card (report, table, stat cards, notice).How multi-query summaries become cards.
build_chart_specBuilds a chart specification from result rows.
summarize_resultsSafe descriptive stats: totals only for metrics that are actually additive.Never sums market share, CTR, or ranks.
explain_analysisExplains what a named analysis would compute and its cost, without running it."How does striking_distance work?"
link_to_reportA deep-link into the Quattr app for the matching report page.Powers "Open in Quattr".
get_query_historyYour recent analysis calls with timing and status.Handy for "what did we run?"

Counts reflect the tools available to connected AI clients. A few additional diagnostic tools exist for Quattr-internal use only.

Example Prompts

Copy-paste any of these into a chat with the Quattr connector enabled. No special syntax needed; they're just questions. Swap the date ranges, segments and competitor names for your own.

Getting better answers

Name the period"last month", "June 2026", "the last 13 weeks". Explicit beats vague. Ranges include both endpoints; weeks run Sunday–Saturday.
Name the scopeSay the segment ("my Hosting segment"), tracker, country or device if you want one. Otherwise you get the whole-domain default.
Organic vs paidSearch metrics default to organic. Say "paid" or "Google Ads" when you mean spend-side numbers.
Ask "is it real?"Any surprising change can be significance-tested; just ask whether it's real or noise.

Search performance

What were my total organic clicks and impressions for last month?
Top 10 keywords by clicks for last month.
How many unique keywords and pages did we rank for last month?
Break down last month's clicks by country.
Top pages by impressions last month on mobile.
How did my clicks and impressions last month compare to the month before?
Which keywords moved the most last month vs the previous month?
Weekly clicks by page for the last 8 weeks, top 5 pages.
What are my quickest-win SEO opportunities right now?
Which non-branded keywords are closest to page 1, and how many clicks could we gain?
What's our average position for branded keywords?

Market share & competitors

How's my market share for last month? Who leads, and what's the gap?
What's my non-branded market share vs competitors for last month?
Top 5 intents by clicks and market share for last month.
Compare my market share against <competitor A> and <competitor B> for last month.
Are we growing faster than our market share?
Which pages had the largest market-share gains vs the previous month?
How many featured snippets do we have vs competitors?
Who leads on Google AI Overviews inclusion this month?
Where are competitors beating us on keywords?
What's our total share of the search page, organic plus paid?

AI visibility

How visible are we across AI assistants like ChatGPT and Perplexity?
Is our AI visibility going up or down over the last 3 months?
How often were we cited on AI platforms last month?
Which competitors lead us on AI visibility?
Which prompts cite our pages the most in AI answers?
Which AI prompts don't cite us at all?
Which of our pages do AI answers cite most?

Paid search

How much did we spend on Google Ads last month, and what was the cost per conversion?
How much of the available paid impressions are we winning?
Are we paying for keywords we already rank for organically?

Web analytics & conversions

How is my website traffic doing? Sessions, users and engagement for last month.
How many conversions did we get last month, broken down by goal?
Where do users drop off between sessions, conversions and transactions?
Did our conversion rate really change vs the previous month, or is it just noise?

Site health (Core Web Vitals)

Any Core Web Vitals problems? Which pages are weakest?
Compare our Core Web Vitals on mobile vs desktop.
Do our highest-traffic pages have slow LCP?

Crawlers & site structure

Are AI crawlers like GPTBot and ClaudeBot reaching our content?
Are fake Googlebots hitting our site?
Where are we wasting crawl budget?
Which of our pages are blocked from indexing, and why?
Find pages on our site that no internal link points to.

Cross-checks & helpers

Our clicks dropped 20% last month. Is that real or noise?
Do pages with worse Core Web Vitals get fewer clicks?
What data sources are connected for my site, and how fresh is each one?
Preview my most-used dashboard.
Keep exploring
Where a card shows "Open in Quattr", click it. The Quattr app opens on the matching page with the same segment, filters and date window already applied.

Troubleshooting, Security & FAQ

Most issues resolve with one of three moves: reconnect the connector, start a new conversation, or sign in to the Quattr app once. Details below.

Connection & sign-in issues

What you seeWhat it meansFix
"No Quattr/Looker account for <email>" at sign-inYour email has never signed in to the Quattr app, so no account exists to bind to.Log in to www.quattr.com once with the same email, then retry the connector sign-in.
Sign-in loops or "unauthorized" after previously workingYour token expired or was revoked.Disconnect and reconnect the connector; in Claude Code run /mcp and re-authenticate. In Cursor, "Clear All MCP Tokens" from the Command Palette also helps.
"This client is not permitted" during authorizationYour AI client isn't on Quattr's approved-client allowlist.Use an approved client (Claude, Claude Code, ChatGPT, Cursor, VS Code) or ask Quattr to approve your client. Details →
"Session unknown or terminated"Your session expired (7 days idle) or the server was updated.Nothing to do; the client re-initializes automatically. If it persists, start a new conversation.
"Tenant changed since session initialization"Your Quattr account switched to a different customer mid-conversation.Start a new conversation (or reconnect). Conversations are pinned to the customer they started with.
"Too many requests; retry in N seconds"You hit the 60 requests/minute per-user limit.Wait a few seconds. Break huge multi-part requests into smaller questions.
"Budget exhausted; resets at midnight UTC"Your account used its daily analysis budget.Resume after the UTC reset, or contact Quattr if your team regularly needs more.
"Overloaded" / brief 503sMomentary capacity protection (concurrent queries, or a deploy in progress).Retry in a few seconds; the assistant usually does this itself.
Tools missing right after a Quattr releaseThe client cached an older tool list.Refresh/reconnect the connector and start a new conversation.
Results show as plain text, no visual cardYour client doesn't render interactive MCP cards (e.g. Claude Code), or the host skipped the visual.Expected. The numbers are identical. Use "Open in Quattr" style links when offered.
Quick self-test
Ask "What data sources are connected for my site, and how fresh is each one?". If that answers with your site's sources, your connection, sign-in and company scoping are all working.

Understanding your numbers

The numbers don't match what I see in the Quattr app

Check the card's scope strip first: date range, segment, organic vs paid, brand filter, device. The most common causes: a different date window (ranges include both endpoints; weeks run Sunday–Saturday), a different segment (the default "Overall Market" covers your whole domain; a tracked segment covers only its keywords), or comparing an organic-only number to a blended one. Cards carry an "Open in Quattr" link that opens the app with the same scope applied; use it to compare apples to apples.

Why is my market share such a small number?

Market-share values are already percentages on a 0–100 scale: 0.03 means 0.03%, not 3%. Deltas are in percentage points. Shares, rates and ranks are never summed into totals; that would be statistically meaningless, and the tools refuse to do it.

Why does data look a day or two behind?

Sources load on different cadences: Search Console lags 1–2 days, web analytics loads nightly, market share / AI visibility / Google Ads roughly daily, and Core Web Vitals typically refresh about every two weeks. Every card's footer shows an "as of" date. Ask "How fresh is my data?" for the live per-source picture.

Why did the assistant refuse part of my question?

By design, the Quattr MCP refuses rather than approximates. For example, shares, rates and ranks are never summed into totals; a request like that gets a clear refusal instead of a misleading number. The refusal message names what is supported; usually a small rephrase gets you there.

What does the "observational" badge mean?

The data shows what happened, not what caused it. A correlation between, say, slow pages and fewer clicks is a lead worth investigating, not proof. Significance tools ("is this real or noise?") tell you whether a change is statistically meaningful, which is still not the same as knowing its cause.

It says a data source "isn't available". Is that a bug?

No. Tool availability follows your Quattr subscription and connected feeds (e.g. Google Ads, site crawl, BigQuery). The honest "not available" prevents wrong numbers. If you believe you should have that source, contact your Quattr customer success manager.

Security & privacy

Sign-in & tokens

OAuth 2.1 authorization-code flow with PKCE. No API keys or passwords ever enter the AI client. Access tokens are short-lived and cryptographically signed; refresh tokens rotate on every use and can be revoked.

Permission inheritance

The MCP inherits the Quattr permissions of the user who signs in, so you can only read data your account already has access to. Connecting grants no additional access.

Tenant isolation

Your identity maps to your Quattr account, and every query runs inside your organization's data scope, enforced at the data layer. One conversation is bound to exactly one customer, and every result is labeled with its company_name.

Read-only

The connection is scoped to quattr:read. Nothing the assistant does through the MCP can modify your Quattr configuration or data.

Approved clients only

Only AI clients explicitly approved by Quattr can complete sign-in; unknown clients are rejected before any data access.

Audit trail

Tool calls are audit-logged server-side and shipped to durable storage, so usage is traceable per user and organization.

AI processing

The AI assistant you connect (Claude, ChatGPT, etc.) processes query results to write its answers, under that provider's terms. Review your organization's policies on AI-powered data analysis and any compliance requirements (e.g. GDPR, CCPA) before broad rollout.

Answers are AI-generated

Quattr supplies the data; the narrative around it is generated by your AI assistant, which can make mistakes. Verify important numbers via "Open in Quattr" before acting on them.

General FAQ

Do I need to know tool names or write SQL?

No. Ask questions in plain language; the assistant discovers and calls the right tools. The tool reference exists so you know what's possible, not because you need it.

Which AI clients are supported?

Claude (claude.ai web and desktop), Claude Code, ChatGPT (developer mode), Cursor, and VS Code. Other MCP clients can be approved on request; see Connect & Settings.

Can my teammates use it?

Yes. Anyone with a Quattr account for your organization can connect with their own email. Access is per-user; there are no shared keys.

I work with multiple Quattr customers. How do I switch?

Switch customers in the Quattr app as usual, then start a new conversation (or reconnect the connector). Existing conversations stay pinned to the customer they started with, and every result's company_name tells you which one you're looking at.

How do I report a wrong or confusing answer?

Use "Open in Quattr" to compare the card with the app view, note the question you asked and the card's scope strip, and share both with your Quattr customer success contact. That scope information is exactly what the team needs to reproduce the issue.

Does the MCP work with BigQuery-level Search Console data?

If your account has the BigQuery feed, say so explicitly, e.g. "using the BigQuery source, top queries by clicks…". It returns far more granular per-query data (privacy-suppressed queries appear under "[anonymized by google]"). Without the entitlement you'll get an honest "not enabled".

Still stuck?
Verify your setup against Connect & Settings, run the quick self-test above, then contact your Quattr customer success manager with the exact error text and your AI client's name/version.