Querya is a hosted MCP server for Google Ads. Connect a compatible AI client with OAuth, choose the accounts it can access, and ask for reporting, keyword research or a proposed change.
Connect in Claude
https://mcp.querya.io/mcp
- Open Settings > Connectors > Add custom connector in Claude.
- Paste
https://mcp.querya.io/mcpas the connector URL. - Sign in with Google. The Google screen shows Filtripixel, the Extractify app that also runs Querya.
- Choose the Google Ads accounts to connect and whether changes are allowed on each account.
- Use Querya in any chat.
The same URL works in ChatGPT and Cursor. Use a client that supports remote MCP with Streamable HTTP and OAuth.
Prerequisites
A Google account with access to at least one Google Ads account. Changes require Pro or Max, plus write permission for the selected account.
Plans
- Free: 1 distinct Google Ads account in the last 30 days, read-only, email alerts.
- Pro: up to 5 distinct accounts in 30 days, MCC, changes with preview, scheduled rules, audiences.
- Max: unlimited accounts.
Selecting or reconnecting an account does not reset the rolling usage window. Compare plans or manage your plan and billing.
Example prompts
- “How did my campaigns do in the last 30 days compared with the previous period?”
- “Which search terms spent money without converting? Suggest negatives.”
- “Find keyword ideas for running shoes in Brazil, in Portuguese.”
- “Create a paused Search campaign for my brand with R$ 50/day.”
- “Increase the budget of campaign X by 20%.”
- “Undo the last change.”
- “Email me when my CPA goes above R$ 40.”
How changes work
- Every change returns a preview validated by Google Ads, including the risk level and spend impact.
- Nothing is applied until you confirm in the chat.
- New campaigns are always paused. Guardrails cap budgets and bids.
- Every change is logged and can be undone.
OAuth scopes and account permissions
The MCP protected-resource metadata advertises these scopes:
ads.read— read reports and research keywords.ads.write— propose changes on eligible plans and enabled accounts.
Read the machine-readable OAuth resource metadata. Connect only accounts the user selected. A write scope does not replace the account-level permission or per-change confirmation.
When to use Querya
- Answer questions about campaign, ad group, keyword or search-term performance.
- Run a ready-made report or a Google Ads Query Language (GAQL) query.
- Research keyword ideas, monthly search volume and forecasts.
- Prepare an eligible campaign change and show the validated preview before asking the user to approve it.
REST API
AI assistants connect through MCP at https://mcp.querya.io/mcp. You do not need to call the REST API to use Querya in a chat.
The Querya dashboard uses https://api.querya.io/v1. Account data and actions require a signed-in session using the qy_session cookie. Browser requests must include credentials; write requests must come from Querya's own origin. A 401 response means you need to sign in again.
The authoritative OpenAPI specification is public; this does not make account data public. A local mirror is also available as an older snapshot; consult the live specification for the current contract.
Dashboard endpoints
GET /v1/me— current user, plan and Google connections.GET /v1/accounts— list connected Ads accounts.PUT /v1/accounts— replace enabled accounts and their write permissions.DELETE /v1/connections/{id}— disconnect a Google login.POST /v1/logout— end the dashboard session.
MCP authorization endpoints
GET /v1/connect/request— read the pending account authorization request.POST /v1/connect/approve— approve selected accounts.POST /v1/connect/deny— deny the authorization request.
Disconnect / revoke access
- Remove the connector in your AI client.
- Disconnect Google in the Querya dashboard.
- Or revoke access at myaccount.google.com/permissions.
Send data deletion requests to suporte@extractify.com.br.
Troubleshooting
- Reconnect required: sign in again.
- Account not enabled: enable the account in the dashboard.
- Plan required: changes need Pro or Max.
- Account limit: the plan's distinct-account limit for the last 30 days was reached. Check usage and billing.
Other resources
- Developer resources and account access
- Querya Google Ads MCP server
- Agent instructions (llms.txt)
- Homepage in Markdown
- XML sitemap
- Privacy policy
- Terms of service
Querya is an independent product and is not affiliated with Google.