Set up FlexQueries MCP

FlexQueries MCP lets compatible AI clients call FlexQueries tools for keyword research, SERP inspection, local business research, competitive search intelligence, domain research, backlink overview, saved keywords, rank tracking, and Google Search Console performance and URL inspection.

The hosted MCP server URL is:

https://app.flexqueries.com/mcp

The first connection sends you through FlexQueries login. After authorization, your MCP client can call FlexQueries tools with the project context and account scopes you approved.

For the current setup flow and a copyable endpoint, open the FlexQueries MCP guide.

Claude Code

Use user scope to make FlexQueries available across projects. Use local scope for the current repository.

claude mcp add --transport http --scope user flexqueries https://app.flexqueries.com/mcp

After adding the server, approve the FlexQueries login when prompted.

Claude Desktop

1. Open Customize -> Connectors.
2. Click +, then Add custom connector.
3. Paste https://app.flexqueries.com/mcp.
4. Approve the FlexQueries login when prompted.

Claude supports custom connectors on Free and paid plans, with one custom connector slot on Free. Team and Enterprise owners add connectors for their organization. See Claude’s current setup guide for plan and workspace details.

Cursor

Add the FlexQueries entry to .cursor/mcp.json in your project, or ~/.cursor/mcp.json to make it available across projects. If the file already contains servers, keep them and merge this entry into mcpServers:

{
  "mcpServers": {
    "flexqueries": {
      "url": "https://app.flexqueries.com/mcp"
    }
  }
}

Approve the FlexQueries login when prompted. You can manage installed servers in Cursor's Customize page. See the Cursor MCP guide for configuration and authentication details.

Codex CLI

Run this in your terminal:

codex mcp add flexqueries --url https://app.flexqueries.com/mcp
codex mcp login flexqueries

Approve the login when prompted.

Codex Desktop

1. Open Settings -> MCP servers.
2. Select Add server and name it FlexQueries.
3. Choose Streamable HTTP and enter https://app.flexqueries.com/mcp.
4. Save, restart the server, and select Authenticate to sign in.

The desktop app and Codex CLI share MCP configuration on the same host, so the CLI commands above are another setup option. See OpenAI’s MCP documentation for current client instructions.

Billing and permissions

FlexQueries has no subscription or per-seat fee. Eligible new accounts receive $1 in starting balance; paid reloads start at $5. Search Console performance and URL inspection do not use your FlexQueries balance. AI client or model-provider fees are separate.

Metered MCP calls, including data research and audit jobs, spend from the same balance as the app. The server authorizes funds before requesting paid data and settles the final cost against usage. A call can incur a charge when your agent invokes it; it does not open a separate app confirmation screen. Set your agent's tool-confirmation preferences and use the pricing estimator to plan the workload.

The Search Console connection uses read-only Google access. This does not make the entire MCP server read-only: agents can also save keywords and start supported jobs in authorized projects.

Available tools

FlexQueries MCP exposes tools for SEO research workflows:

• Research keywords with volume, difficulty, and CPC.
• Fetch live Google organic SERP results for keywords.
• Find exact keyword, page, rank, volume, CPC, intent, and traffic rows for a domain or page.
• Compare SERP competitors across a supplied keyword set.
• Search local businesses near a coordinate, fetch one Maps or Local Finder SERP, and read Google Business Q&A when needed.
• Hydrate keywords with search volume, difficulty, intent, CPC, and trends.
• List saved keywords from a FlexQueries project.
• Save useful keywords back to FlexQueries.
• Start site audits, check their status, and inspect page issues.
• Read AI visibility monitoring and web-mention research.
• Read rank tracker configs and latest keyword positions.
• Summarize a domain's organic footprint.
• Find keywords a domain already ranks for.
• Check backlink and referring-domain overview data.
• Read first-party Google Search Console performance (clicks, impressions, CTR, position).
• Inspect index status, crawl, and canonical for specific URLs (up to 10 per call).

What to do after setup

Once FlexQueries MCP is connected, use the agent workflow guides for focused SEO jobs.

Start with one focused workflow instead of asking your agent to "do SEO" broadly.

• Use SEO project setup to capture your SEO goals and website context in a local workspace.
• Use SEO coach if you are new to SEO or are not sure which workflow to run first.
• Use keyword research to discover keyword opportunities.
• Use competitive landscape to map a market before choosing competitors or pages.
• Use competitor analysis to study one competitor.
• Use keyword clustering to turn keywords into page groups.
• Use link prospecting to find outreach prospects for a linkable asset.

Troubleshooting

If your client cannot connect, check that the server URL is exactly https://app.flexqueries.com/mcp.

If authorization fails, disconnect the FlexQueries server in your client, add it again, and repeat the login flow.

If your agent cannot find a project, ask it to list FlexQueries projects first and use the returned project ID in later tool calls.