본문으로 건너뛰기

AI Rank Lab MCP server: setup for Claude, Claude Code and Cursor

Connect AI Rank Lab to any MCP client and your AI agent can run keyword research, live Google SERP, AI Overview and AI Mode lookups, the SEO + AEO + GEO checker, brand-visibility checks and backlink lookups, and read your GA4 and Search Console data. Same tools and credits as the REST API.

Works with Claude.ai, Claude Desktop, Claude Code, Cursor, Any Streamable HTTP MCP client.

fieldnote.app4,571크레딧

Claude Code · airanklab

keyword-research · United States

예시 데이터
Keywords
10
Credits
400
“Research keywords for mcp seo”
  • mcp seovol · KD · intent
  • seo mcp servervol · KD · intent
  • keyword research mcpvol · KD · intent

Setup guide and reference

Introduction

The Model Context Protocol (MCP) is an open standard that lets AI assistants call external tools. Our MCP server is a thin layer over the /api/v1 REST API: same tools, same credit billing, same account, but callable by Claude, Cursor or any other MCP client as part of a conversation.

It uses the Streamable HTTP transport in stateless mode, so there is nothing to install or host. Point your client at the endpoint with your API credentials. 33 tools are available today.

Endpoint and authentication

The server lives at a single endpoint:

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

Every request carries the same two headers as the REST API: x-api-key and x-api-secret. Generate both in the dashboard under Developer API → API Keys.

Your MCP client config stores the secret in plain text on your machine. Keep the config file out of version control, and rotate the key pair from the dashboard if it ever leaks.

Claude.ai (web app)

In Claude.ai, open Add custom connector. Claude.ai does not support custom headers, so your credentials go in the URL query string. Paste this into Remote MCP server URL, replace the placeholders, and leave the Advanced OAuth fields blank.

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

Because the credentials sit in the URL, they may appear in our server access logs. Use the URL exactly as shown: the www host and no /sse suffix. Claude.ai posts to the exact URL you paste; a different host or path returns an error, and Claude then falls back to an OAuth sign-in that this server does not offer.

Claude Code

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

Terminal
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 things like “Run the SEO AEO GEO check on example.com” or “Who does Google's AI Overview cite for best crm?”. Claude Code calls seo-aeo-geo-audit and google-ai-overview for you.

Claude Desktop

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

claude_desktop_config.json
{
  "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:

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

Keyword research over MCP

keyword-research is real Google keyword data inside your agent. Give it up to 10 seed keywords for their metrics and on-topic expansions, or a website URL to see the keywords that domain ranks for and its position for each. Choose the market and language; the default is the United States in English. Run keyword-research-estimate first if you want the credit cost before you spend it.

  • “Research keywords around “generative engine optimization” in the US and sort by volume.” → keyword-research
  • “Which keywords does competitor.com rank for in the United Kingdom, and at what position?” → keyword-research
  • “How many credits would that keyword research cost before I run it?” → keyword-research-estimate
  • “Show the live Google results for “mcp seo” on mobile in India.” → google-search
  • “Does Google show an AI Overview for “best seo mcp server”, and who does it cite?” → google-ai-overview
  • “Which of my queries in Search Console sit at positions 8–15 with 500+ impressions?” → gsc-performance

Tools and credits

MCP tools mirror the REST endpoints and spend the same credit balance. Reads of your own data are free, and a paid call is charged up front and refunded automatically if it fails. One tool is billed differently over MCP: keyword-research is metered at 100 credits per data lookup (typically 400 to 500 credits a run), where the REST endpoint charges a flat 50. The maximum is reserved when the run starts and the unused part is returned.

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 between the two, so measure the one your buyers use. search-locations lists every supported market. The GA4 and Search Console tools read the accounts you connected in the dashboard.

ai-citation-check asks ChatGPT, Perplexity, Claude and Gemini the same question in one call and is billed per engine, so naming fewer engines costs less. The backlink tools work on any domain, so an agent can research a competitor's link profile directly; the free backlink-filters tool lists the presets and fields they accept.

AI search visibility

AI search visibility tools and credits
ToolWhat it doesCredits per call
ai-citation-checkAsk ChatGPT, Perplexity, Claude and Gemini one question with live web search and see who each one cites100 credits per engine (400 for all four)
brand-visibilityAsk one AI engine (ChatGPT, Claude, Gemini or Perplexity) a prompt and analyse your brand in the answer100 credits per engine run
google-ai-overviewGoogle's AI Overview for one query, country and device, with every source URL it cites100 credits
google-ai-modeGoogle's AI Mode answer for one query, country and device, with its sources100 credits
citationsRecent citations of your domain by AI engines: which bot cited which page, and whenFree
list-promptsThe AI prompts you track for brand visibility, filtered by domain, status or categoryFree
prompt-citationsWhich URLs and domains won AI citations for one tracked prompt over a lookback windowFree
action-planResearch the top-cited URLs for a tracked prompt and get grounded article topics that could win the citation20 credits

Keywords and SERPs

Keywords and SERPs tools and credits
ToolWhat it doesCredits per call
keyword-researchVolume, CPC, difficulty, intent and 12-month trend for up to 10 seeds or a whole domain, plus the live SERP for top keywords100 credits per data lookup (typically 400–500 a run)
keyword-research-estimateQuote a keyword-research run before you spend anything: lookups, typical and maximum cost, your balanceFree
google-searchLive Google results for one query, country and device: organic positions, featured snippet, People Also Ask100 credits
search-locationsEvery country, language and device the three Google tools acceptFree

Audits and fixes

Audits and fixes tools and credits
ToolWhat it doesCredits per call
seo-aeo-geo-auditThe full three-pillar checker: SEO, AEO and GEO scores out of 100 with one prioritised fix list50 credits
auditsTechnical, SEO and AEO audit of a single URL50 credits
core-web-vitalsGoogle PageSpeed and Core Web Vitals for a URL25 credits
faq-generatorFAQ question and answer pairs plus FAQPage JSON-LD from a page URL20 credits
llms-txtAn llms.txt file for a website, following the llmstxt.org specification20 credits

Backlinks

Backlinks tools and credits
ToolWhat it doesCredits per call
backlinks-overviewBacklink profile summary for any domain: rank, referring domains, spam score15 credits
backlinks-historyMonth-by-month backlink trend with new and lost links15 credits
backlinks-listEvery individual backlink to a domain or URL, with anchors, authority and spam signals150 credits
referring-domainsDomains linking to any site, ranked by authority25 credits
anchor-textAnchor text distribution and over-optimisation signals25 credits
bulk-domain-authorityAuthority rank for up to 100 domains in one call25 credits
backlink-filtersThe filter presets, modes and fields the backlink tools acceptFree

Your own data

Your own data tools and credits
ToolWhat it doesCredits per call
gsc-performanceSearch Console clicks, impressions, CTR and position by query, page, country, device or dateFree
gsc-sitesThe Search Console properties you connected, with the siteUrl to pass onFree
ga4-reportAny GA4 metrics broken down by any GA4 dimensions over your connected propertyFree
ga4-realtimeGA4 activity in the last 30 minutesFree
ga4-propertiesThe GA4 accounts and properties you connected, with the propertyId to pass onFree
tracking-statsAI bot visit stats for one of your domains: totals, top bots, top pagesFree
list-domainsThe domains on your account, with tracking-script status and your credit balanceFree
add-domainRegister a new domain and get its tracking scriptFree
creditsYour credit balance and recent transactionsFree

Long-running tools

Heavier tools such as audits and brand visibility normally finish within the request. Each call has a 120-second budget: if the work is not done in time, the tool returns a jobId with polling instructions instead of the result.

Poll GET /api/v1/jobs/:jobId (REST, same headers) until the status is completed. See async jobs in the API reference.

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.

자주 묻는 질문

다른 궁금한 점이 있나요? 팀에 문의하기

What is the AI Rank Lab MCP server?

A remote Model Context Protocol server at https://www.airanklab.com/api/v1/mcp. It exposes the AI Rank Lab developer API as tools, so Claude, Cursor and other MCP clients can call them during a conversation.

Can I get SEO data in Claude automatically through an MCP server?

Yes. Add the server to Claude.ai, Claude Desktop or Claude Code with your API key and secret, then ask in plain English. Claude picks the tool, such as keyword-research or gsc-performance, and runs it for you.

Can I run AI visibility checks directly from Claude or Cursor?

Yes. ai-citation-check asks ChatGPT, Perplexity, Claude and Gemini one question and reports who they cite; brand-visibility asks one engine about a brand; google-ai-overview and google-ai-mode show Google's AI answers and their sources.

Is there a keyword research MCP?

Yes. keyword-research takes up to 10 seed keywords, or a website URL to see the keywords that domain ranks for, in the market and language you choose. It returns volume, CPC, difficulty, intent and 12-month trend. It is billed at 100 credits per data lookup, usually 400 to 500 credits a run, and keyword-research-estimate quotes the cost first for free.

How is the MCP server billed?

In credits from your AI Rank Lab plan. Most tools cost the same as the matching REST API call, from 15 to 150 credits, and ai-citation-check costs 100 per engine. keyword-research is metered per data lookup over MCP. Reads of your own GA4, Search Console, bot-visit and citation data are free, and failed calls are refunded.

Is there an SEO MCP server for Claude?

Yes. The AI Rank Lab MCP server works in Claude.ai as a custom connector, in Claude Desktop through claude_desktop_config.json, and in Claude Code with one claude mcp add command. Once connected, Claude can run keyword research, Google SERP and AI Overview lookups, audits and Search Console reports.

Do I need to install or host anything?

No. The server runs on AI Rank Lab over Streamable HTTP in stateless mode. You add one URL and two credentials to your client.

Why doesn't Claude.ai accept my connector URL?

Use the exact URL with the www host, /api/v1/mcp path and your key and secret as query parameters, with no /sse suffix. A different host or path fails, and Claude then offers an OAuth sign-in this server does not support.

What are the rate limits?

MCP calls share the REST API limit of 60 requests per minute per key by default. A 429 response includes Retry-After. Contact us if you need more.

Connect your agent

Generate your API key and secret, paste one config block, and your AI agent can run real marketing tools. Or start with the free audit.