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

# MCP Server for Qwairy

> Connect any AI assistant to your Qwairy GEO monitoring data using the Model Context Protocol (MCP).

The Qwairy MCP Server lets AI assistants access your GEO monitoring data directly. Ask questions about your brand's AI visibility in natural language and get instant insights — from any MCP-compatible client.

## What is MCP?

The [Model Context Protocol (MCP)](https://modelcontextprotocol.io) is an open standard that allows AI assistants to securely connect to external data sources. With Qwairy's MCP server, you can:

* **Query your GEO performance** — "How is my brand performing across AI providers?"
* **Analyze competitors** — "Who are my top competitors in AI responses?"
* **Track sources** — "Which domains cite my brand most often?"
* **Monitor prompts** — "Show me recent AI responses for my monitored queries"

## Supported Clients

Qwairy's MCP server works with any client that supports the Model Context Protocol:

<CardGroup cols={3}>
  <Card title="Claude Desktop / Claude.ai" icon="message">
    Via Connectors settings
  </Card>

  <Card title="ChatGPT" icon="comments">
    Via Connectors (Pro/Team/Enterprise)
  </Card>

  <Card title="Cursor" icon="code">
    Built-in MCP support
  </Card>

  <Card title="Claude Code" icon="terminal">
    One-command CLI setup
  </Card>

  <Card title="VS Code / Copilot" icon="microsoft">
    Via MCP extension
  </Card>

  <Card title="Windsurf" icon="wind">
    Built-in MCP support
  </Card>
</CardGroup>

<Note>
  Any MCP-compatible client can connect using the server URL `https://mcp.qwairy.co`. See [Getting Started](/mcp/getting-started) for setup instructions.
</Note>

## Quick Example

Once connected, you can have conversations like:

> **You:** What's my brand's GEO score this month?
>
> **AI Assistant:** Your brand "Acme Corp" has a GEO score of 72/100. Here's the breakdown:
>
> * Mention Rate: 45% (brand mentioned in 45% of AI responses)
> * Source Rate: 28% (your domain cited in 28% of responses)
> * Share of Voice: 38% (vs competitors)
> * Sentiment: 78/100

## Available Tools

The MCP server provides **43 tools** across 10 categories:

| Category                | Tools                                                                                                                                        | Description                                                         |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| **Discovery**           | `list_brands`, `list_topics`, `list_tags`, `get_overview`                                                                                    | Discover brands and configuration IDs, then get a cockpit overview  |
| **Performance**         | `get_brand_performance`, `get_visibility_trend`, `get_sentiment_trend`, `get_provider_breakdown`, `get_keyword_triggers`, `get_topics`       | GEO scores, trends, provider and keyword analysis                   |
| **Competitors**         | `get_competitors`, `get_competitor_evolution`, `get_competitor_comparison`, `get_competitor_position`                                        | Rankings, trends, head-to-head, deep-dive                           |
| **Prompts & Responses** | `get_prompts`, `get_prompt_answers`, `get_answers`, `get_answer_details`, `get_prompt_signals`                                               | Browse prompts, AI responses, attack/defend signals                 |
| **Sources**             | `get_source_domains`, `get_source_urls`, `get_source_profile`, `get_backlink_opportunities`                                                  | Cited domains, URLs, source deep-dive, backlink outreach            |
| **Strategic**           | `get_content_opportunities`, `get_brand_perception`, `get_perception_history`, `get_technical_status`, `get_site_diagnostics`, `get_actions` | Perception SWOT, technical SEO, per-page diagnostics, Action Center |
| **Vertical Insights**   | `get_shopping_insights`, `get_social_insights`, `get_local_insights`, `get_query_fan_out`, `get_sponsored_content`                           | Shopping, social, local, web search queries, sponsored content      |
| **Measure**             | `get_search_console_metrics`, `get_bing_metrics`, `get_referrer_analytics`, `get_ai_revenue`, `get_crawler_activity`, `get_page_performance` | Search Console, Bing, AI traffic and revenue, crawler activity      |
| **Deep-Dive**           | `get_page_presence`, `get_matrix`                                                                                                            | On-page presence, visibility matrix                                 |
| **Documentation**       | `search_documentation`                                                                                                                       | Search Qwairy product docs, guides, and GEO strategies              |

<Note>
  The **Measure** tools require the `read:measure` scope and a connected integration (Google Search Console, Bing, or Google Analytics). See [Measure Tools](/mcp/tools/measure).
</Note>

## Requirements

* **Qwairy Starter plan** or higher
* Any **MCP-compatible AI client** (Claude, Cursor, VS Code, Windsurf...)
* Active monitored brands with GEO data

## Next Steps

<CardGroup cols={2}>
  <Card title="Getting Started" icon="rocket" href="/mcp/getting-started">
    Set up the MCP connection in 2 minutes
  </Card>

  <Card title="OAuth Setup" icon="key" href="/mcp/oauth">
    How authentication works
  </Card>

  <Card title="Discovery Tools" icon="magnifying-glass" href="/mcp/tools/discovery">
    List your monitored brands
  </Card>

  <Card title="Performance Tools" icon="chart-line" href="/mcp/tools/performance">
    GEO scores and topic metrics
  </Card>

  <Card title="Competitor Tools" icon="users" href="/mcp/tools/competitors">
    Analyze competitive landscape
  </Card>

  <Card title="Response Tools" icon="messages" href="/mcp/tools/responses">
    Browse prompts and AI responses
  </Card>

  <Card title="Source Tools" icon="link" href="/mcp/tools/sources">
    Track cited domains and URLs
  </Card>

  <Card title="Strategic Tools" icon="bullseye" href="/mcp/tools/strategic">
    Actions, perception, technical status
  </Card>

  <Card title="Insight Tools" icon="lightbulb" href="/mcp/tools/insights">
    Shopping, social, local, queries
  </Card>

  <Card title="Measure Tools" icon="chart-mixed" href="/mcp/tools/measure">
    Search Console, AI traffic, revenue, crawlers
  </Card>

  <Card title="Deep-Dive Tools" icon="microscope" href="/mcp/tools/deep-dive">
    Page presence, matrix, profiles
  </Card>

  <Card title="Documentation Tool" icon="book" href="/mcp/tools/documentation">
    Search product docs and GEO guides
  </Card>

  <Card title="Examples" icon="code" href="/mcp/examples/getting-started">
    Real conversation examples
  </Card>
</CardGroup>