Skip to main content
Connect your favorite AI assistant to your Qwairy GEO monitoring data. All you need is the server URL: 
https://mcp.qwairy.co
Authentication is handled automatically via OAuth — a browser window opens, you sign in, and you’re connected.
MCP is an open protocol that is still evolving. Some clients may update their setup flow over time. If the steps below don’t match exactly what you see, refer to your client’s documentation — the server URL remains the same.

​
Prerequisites

  • A Qwairy Starter plan or higher
  • At least one active brand with monitoring data
  • An MCP-compatible AI client (see options below)

​
Choose Your Client

  1. Go to Settings → Connectors
  2. Click Add custom connector
  3. Enter a name (e.g. Qwairy) and the server URL:
https://mcp.qwairy.co
  1. Click Add, then authorize the connection when prompted
This works the same way on Claude Desktop (macOS/Windows) and Claude.ai (web).

​
Authorize the Connection

After adding the server, your client will initiate the OAuth flow:
  1. A browser window opens with the Qwairy sign-in page
  2. Sign in with your Qwairy account
  3. Authorize the connection
  4. You’re redirected back — the connection is active
Your credentials are never shared with the AI client. Authentication uses OAuth 2.1 with PKCE — only a secure, scoped access token is exchanged. Learn more about OAuth.

​
Start Querying Your Data

Try these example prompts: 
What brands am I monitoring?

Show me my GEO performance for the last 30 days

Who are my top competitors in AI responses?

Which sources cite my brand most often?

What are the top content opportunities for my brand right now?

Compare my brand's sentiment across different AI providers

Which prompts are driving the most visibility for my competitors?

​
Troubleshooting

​
”Server not found” error

  • Ensure the URL is exactly https://mcp.qwairy.co (no trailing slash)
  • Check that your config file is valid JSON
  • Restart your AI client after editing the config

​
”Authentication failed” error

  1. Check that you have a Starter plan or higher
  2. Ensure you’re signing in with the correct Qwairy account
  3. Try disconnecting and reconnecting

​
”No data returned”

Make sure you have:
  • At least one brand with status “Live”
  • Monitoring enabled with generated responses
  • Recent data (within the last 30 days by default)

​
Client doesn’t support remote MCP?

Use the mcp-remote bridge — see the Other Clients tab above.

​
Rate Limits

The MCP server allows 300 requests per minute and 3,000 requests per day per connection. This is more than enough for interactive use, but automated scripts should implement appropriate delays.

​
Measure Tools and Scopes

Tools that read off-AI analytics (Search Console, Bing, referrer traffic, AI revenue, crawler activity) live under the Measure category and require the read:measure scope. If you connected before this scope existed, disconnect and reconnect to pick it up — scopes are never expanded silently on an already-issued token. See Measure Tools.

​
Next Steps

Tools Reference

Learn what each tool does and its parameters

Example Conversations

See real-world usage examples

Combine with Other Tools

Connect Qwairy with your SEO, CMS, and project management tools

OAuth Setup

How authentication works under the hood