AI Rank Lab tools, inside your AI agent

Introduction

Endpoint & authentication

POST https://www.airanklab.com/api/v1/mcp

Claude.ai (Web App)

To connect the MCP server directly in the Claude.ai web interface, open the Add custom connector dialog. Claude.ai does not support custom headers, so your credentials go in the URL query string instead.

Paste the following URL into the Remote MCP server URL field, replacing the placeholders with your actual API key and secret. Leave the Advanced OAuth fields blank.

https://www.airanklab.com/api/v1/mcp?x-api-key=YOUR_API_KEY&x-api-secret=YOUR_API_SECRET

Claude Code

One command adds the server to Claude Code (CLI v1.x or later):

claude mcp add --transport http airanklab https://www.airanklab.com/api/v1/mcp \
  --header "x-api-key: YOUR_API_KEY" \
  --header "x-api-secret: YOUR_API_SECRET"

Then ask Claude Code things like “run the SEO + AEO + GEO check on example.com and summarize the critical issues” or “who does Google's AI Overview cite for ‘best CRM for startups’ in India on mobile?” — it will call the seo-aeo-geo-audit and google-ai-overview tools for you.

Claude Desktop

Add this to your Claude Desktop configuration (Settings → Developer → Edit Config, file claude_desktop_config.json), then restart the app:

{
  "mcpServers": {
    "airanklab": {
      "url": "https://www.airanklab.com/api/v1/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY",
        "x-api-secret": "YOUR_API_SECRET"
      }
    }
  }
}

Cursor

Add the same block to ~/.cursor/mcp.json (global) or .cursor/mcp.json in your project:

{
  "mcpServers": {
    "airanklab": {
      "url": "https://www.airanklab.com/api/v1/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY",
        "x-api-secret": "YOUR_API_SECRET"
      }
    }
  }
}

Available tools & pricing

MCP tools mirror the REST tool endpoints one-to-one and spend the same credit balance — a tool costs the same whether you call it from the dashboard, the REST API, or MCP. Data reads are free; failed tool calls are refunded automatically.

The three Google tools (google-search, google-ai-overview, google-ai-mode) take a country and a device— name the country (“India”), its ISO code (“IN”) or its numeric location code (2356), and pick desktop or mobile. Results differ markedly between the two, so measure the one your buyers actually use. The search-locations tool lists every supported market. The GA4 and Search Console tools are free because they read your own Google data — connect those accounts in the dashboard first.

ai-citation-check asks ChatGPT, Perplexity, Claude and Gemini the same question in one call and reports which of them cite you — it is billed per engine, so naming fewer engines costs less. The backlink tools (backlinks-overview, backlinks-history, backlinks-list, referring-domains, anchor-text, bulk-domain-authority) work on anydomain, not just the ones registered on your account, so an agent can research a competitor’s link profile directly. The free backlink-filters tool lists the presets, modes and fields the filtered backlink queries accept.

Long-running tools

Rate limits

MCP requests count against the same per-key limit as the REST API: 60 requests per minute by default. A 429 response includes Retry-After. Need a higher limit? Contact us.

Related resources

• REST API reference — full endpoint documentation with request/response samples.
• OpenAPI spec (JSON) — machine-readable schema for codegen.
• Postman collection — ready-made requests for every endpoint.
• API Playground — try every endpoint live from the dashboard.