MCP Server

AI Rank Lab-Tools, in Ihrem KI-Agenten

Der AI Rank Lab MCP-Server stellt dieselben Tools wie die Entwickler-API bereit — den vollständigen SEO-, AEO- und GEO-Checker, Live-Google-Suche, KI-Übersicht und KI-Modus- Abfragen für jedes Land und Gerät, Keyword-Recherche, Core Web Vitals, KI- Markensichtbarkeitsprüfungen, FAQ- und llms.txt-Generierung, sowie Ihre Google Analytics 4, Search Console, Bot-Besuchs- und Zitationsdaten — über das Model Context Protocol. Fügen Sie es zu Claude Code, Claude Desktop oder Cursor hinzu, und Ihr Agent kann sie direkt ausführen.

Get your API key REST API-Referenz

Einführung

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-compatible client as part of a conversation.

The server uses the Streamfähiges HTTP transport in stateless mode, so there is nothing to install or host — you point your client at the endpoint with your API credentials.

Endpunkt & Authentifizierung

Der Server ist über einen einzigen Endpunkt erreichbar:

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

Every request must carry the same two headers as the REST API: x-api-key and x-api-secret. Generate both from Dashboard → API & Integrationen.

Ihre MCP-Client-Konfiguration speichert das Geheimnis im Klartext auf Ihrem Computer. Halten Sie die Konfigurationsdatei von der Versionskontrolle fern, und tauschen Sie das Schlüsselpaar vom Dashboard aus, falls es jemals kompromittiert wird.

Claude.ai (Web-App)

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

Paste the following URL into the URL des externen MCP-Servers field, replacing the placeholders with your actual API key and secret. 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

Da Claude.ai keine benutzerdefinierten Header unterstützt, müssen Sie Ihre Anmeldeinformationen in den URL-Abfrageparametern angeben. Beachten Sie, dass dies dazu führen kann, dass sie in unseren Server-Zugriffsprotokollen erscheinen.

Use the URL exactly as shown — the www. host and no /sse suffix. Claude.ai connects over Streamable HTTP and 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 flow that this server does not offer.

Claude Code

Ein Befehl fügt den Server zu Claude Code hinzu (CLI v1.x oder neuer):

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 Claude Code things like „Führe den SEO + AEO + GEO Check auf example.com aus und fasse die kritischen Probleme zusammen“ or „Wen zitiert Googles KI-Übersicht für ‚bestes CRM für Startups‘ in Indien auf Mobilgeräten?“ — it will call the seo-aeo-geo-audit and google-ai-overview tools for you.

Claude Desktop

Add this to your Claude Desktop configuration (Einstellungen → Entwickler → Konfiguration bearbeiten, 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"
      }
    }
  }
}

Verfügbare Tools & Preise

MCP-Tools spiegeln die REST-Tool-Endpunkte eins zu eins wider und verbrauchen dasselbe Guthaben – ein Tool kostet dasselbe, egal ob Sie es vom Dashboard, der REST API oder MCP aufrufen. Datenlesevorgänge sind kostenlos; fehlgeschlagene Tool-Aufrufe werden automatisch erstattet.

The three Google tools (google-search, google-ai-overview, google-ai-mode) take a Land and a Gerät— name the country (“India”), its ISO code (“IN”) or its numeric location code (2356), and pick Desktop or Mobil. 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, verweisende-domänen, ankertext, massen-domain-autorität) work on beliebigdomain, not just the ones registered on your account, so an agent can research a competitor’s link profile directly. The free backlink-filter tool lists the presets, modes and fields the filtered backlink queries accept.

Tool	Beschreibung	Credits pro Aufruf
`ai-citation-check`	Ask ChatGPT, Perplexity, Claude and Gemini one question and see who cites you	100 per engine
`backlinks-list`	Every individual backlink, with anchors, authority and spam signals	150
`seo-aeo-geo-audit`	Full SEO + AEO + GEO checker — the same three-pillar report as the dashboard	50
`audits`	Technical + AEO audit of a single URL	50
`google-search`	Live Google SERP for one query, by country and device	100
`google-ai-overview`	Google's AI Overview answer and the sources it cites	100
`google-ai-mode`	Google's AI Mode conversational answer and its sources	100
`brand-visibility`	Ask a live AI engine about a brand	100 per engine
`keyword-research`	Keyword volume, difficulty, intent and live SERP	50 typical; billed per lookup
`core-web-vitals`	Core Web Vitals / PageSpeed scan	25
`referring-domains`	Domains linking to any site, ranked by authority	25
`anchor-text`	Anchor text distribution and over-optimization signals	25
`bulk-domain-authority`	Authority rank for up to 100 domains in one call	25
`faq-generator`	Generate an FAQ plus FAQPage schema for a page	20
`llms-txt`	Generate an llms.txt manifest	20
`backlinks-overview`	Backlink profile summary for any domain: rank, referring domains, spam score	15
`backlinks-history`	Month-by-month backlink trend with new and lost links	15
`backlink-filters`	Filter presets, modes and fields the backlink tools accept	Free
`gsc-performance`	Search Console clicks, impressions, CTR and position	Free
`gsc-sites`	Your verified Search Console properties	Free
`ga4-report`	Any GA4 metrics and dimensions over your property	Free
`ga4-realtime`	GA4 activity in the last 30 minutes	Free
`ga4-properties`	Your connected GA4 properties	Free
`tracking-stats`	AI bot visit stats for your domain	Free
`citations`	Where AI engines cite your site	Free
`search-locations`	Countries, languages and devices the search tools accept	Free
`keyword-research-estimate`	Preview a keyword-research cost before running it	Free
`credits`	Current credit balance	Free

Langlaufende Tools

Heavier tools (audits, brand visibility) normally finish within the request. Each call has a 120-Sekunden-Budget: if the work isn't 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 abgeschlossen — see Asynchrone Jobs in the API reference.

Ratenbegrenzungen

MCP requests count against the same per-key limit as the REST API: 60 Anfragen pro Minute by default. A 429 response includes Wiederholen nach. Need a higher limit? Kontaktieren Sie uns.

Verbinden Sie Ihren Agenten

Generieren Sie Ihren API-Schlüssel und Ihr Secret, fügen Sie einen Konfigurationsblock ein, und Ihr KI-Agent kann echte Marketing-Tools ausführen.

Get your API key