Connect an MCP client

Connect your favorite AI assistant to your Qwairy GEO monitoring data. All you need is the server URL:

https://mcp.qwairy.co

OAuth-capable clients discover Qwairy’s OAuth 2.1 flow from this endpoint. Depending on the client, authorization can start automatically, on first use, or after an explicit sign-in command. For headless clients that cannot complete interactive OAuth, create a Personal Access Token under Team Management > MCP Server. Prefer OAuth whenever the client supports it.

MCP client interfaces change independently of Qwairy. The stable inputs are the server URL and OAuth. The client procedures below were verified against the linked vendor documentation on August 28, 2026.

Prerequisites

Access to an active Qwairy team on a Starter plan or higher, including paid Agency plans
A client that supports remote MCP servers over Streamable HTTP
To query monitoring data: at least one accessible active brand with generated responses

Choose a client

Go to Settings → Connectors
Click Add custom connector
Enter a name (e.g. Qwairy) and the server URL:

https://mcp.qwairy.co

Click Add, then authorize the connection when prompted

Custom connectors are available on supported Claude plans. Team and Enterprise workspace owners may need to enable or add the connector for the organization. See Anthropic’s custom connector guide.

Availability and publishing controls depend on your ChatGPT plan and workspace policy. Full MCP support is available on ChatGPT Business, Enterprise, and Edu. ChatGPT Pro supports read and fetch custom apps in developer mode.

Confirm that developer mode is enabled for your account. Business admins and owners can enable it from Workspace Settings > Apps > Create. Authorized Enterprise and Edu users can also use Settings > Apps > Advanced Settings.
Open Apps > Create. In a managed workspace, an owner or administrator may need to grant access first.
Enter a name such as Qwairy and the server URL:

https://mcp.qwairy.co

Select OAuth authentication, scan the tools, and complete the Qwairy authorization flow.
Create the app. A workspace owner may need to publish it before other members can use it.

See OpenAI’s custom app guide for the current plan and workspace controls.

Add Qwairy to ~/.cursor/mcp.json for a personal, cross-project connection. Use a project’s .cursor/mcp.json only when the server should be project-scoped.

{
  "mcpServers": {
    "qwairy": {
      "url": "https://mcp.qwairy.co"
    }
  }
}

Save the file, restart Cursor, then open Customize > MCPs to confirm the server is enabled and complete OAuth. See Cursor’s MCP documentation for current interface steps.

Add the remote HTTP server at user scope, then sign in and verify it:

claude mcp add --transport http qwairy --scope user https://mcp.qwairy.co
claude mcp login qwairy
claude mcp get qwairy

On Claude Code versions without claude mcp login, run /mcp inside Claude Code to complete OAuth. See Claude Code’s MCP documentation for scope and management commands.

Open the Command Palette and run MCP: Add Server.
Choose an HTTP server and enter:

https://mcp.qwairy.co

Choose Global for all workspaces or Workspace for the current repository.
Trust the server when prompted and complete Qwairy authorization.

The equivalent workspace configuration in .vscode/mcp.json is:

{
  "servers": {
    "qwairy": {
      "type": "http",
      "url": "https://mcp.qwairy.co"
    }
  }
}

See VS Code’s MCP server guide for workspace and user configuration options.

Devin Local is the default agent for new Windsurf tabs. Add Qwairy at user scope, then sign in and verify it:

devin mcp add -s user qwairy https://mcp.qwairy.co
devin mcp login qwairy
devin mcp get qwairy

The legacy Cascade agent uses Devin Settings > Cascade > MCP Servers or ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "qwairy": {
      "serverUrl": "https://mcp.qwairy.co"
    }
  }
}

Cascade accepts serverUrl or url for remote HTTP servers. Team policies may require an administrator to enable or allowlist MCP access. See the Devin Local MCP guide and legacy Cascade guide.

Prefer a client’s native Streamable HTTP transport with OAuth and use the URL:

https://mcp.qwairy.co

If a client only supports stdio, choose a maintained HTTP bridge that your organization has reviewed. Pin an approved package and version instead of executing an unpinned package at runtime. Bridge configuration and OAuth callback support are client-specific.

Authorize the connection

After adding the server, your client will initiate the OAuth flow:

A browser window opens with the Qwairy sign-in page
Sign in with your Qwairy account
Authorize the connection
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.

Query 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

Use the root endpoint https://mcp.qwairy.co; do not append /mcp
Check that your config file is valid JSON
Restart your AI client after editing the config

”Authentication failed” error

Check that you have a Starter plan or higher
Ensure you’re signing in with the correct Qwairy account
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?

Prefer a client with native Streamable HTTP and OAuth support. If your organization approves a bridge, pin its version and follow that client’s documented OAuth callback procedure.

Rate limits

The MCP server currently allows 300 requests per minute and 3,000 requests per day per access token. HTTP 429 responses expose X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset for the per-minute window; successful responses do not expose quota headers. The JSON error message’s retry delay is derived from that same per-minute reset. Apply exponential backoff, and if requests remain limited after the reset, stop automated retries and resume later because the daily cap may be exhausted. These service limits can evolve; treat the documented values as current policy and 429 headers as burst-window guidance, not a complete daily-quota signal.

Measurement 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

Get started

Tool reference

Examples

Workflows

Prerequisites

Choose a client

Authorize the connection

Query your data

Troubleshooting

”Server not found” error

”Authentication failed” error

”No data returned”

Client doesn’t support remote MCP?

Rate limits

Measurement tools and scopes

Next steps

Tools Reference

Example Conversations

Combine with Other Tools

OAuth Setup

​Prerequisites

​Choose a client

​Authorize the connection

​Query your data

​Troubleshooting

​”Server not found” error

​”Authentication failed” error

​”No data returned”

​Client doesn’t support remote MCP?

​Rate limits

​Measurement tools and scopes

​Next steps

Tools Reference

Example Conversations

Combine with Other Tools

OAuth Setup

Prerequisites

Choose a client

Authorize the connection

Query your data

Troubleshooting

”Server not found” error

”Authentication failed” error

”No data returned”

Client doesn’t support remote MCP?

Rate limits

Measurement tools and scopes

Next steps