Model Context Protocol (MCP) Server for SEO & AEOV1.0 LIVE

Give your AI agents Live SEO, AEO & Search Intelligence

Connect Claude Code, Cursor, Windsurf, or custom Python/TypeScript agents directly to live Google SERP data, AI brand visibility checks, bot visit logs, and page audits — over Anthropic's open Model Context Protocol.

Quick Setup — 1-Command Add

Add AI Rank Lab tools directly to your terminal agent in one command.

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"
Interactive Agent Workflow

How AI Agents execute SEO tasks over MCP

Your AI agent uses natural language reasoning to plan, query AI Rank Lab's real search database, and update code or output reports in real time.

Zero Custom Scrapers RequiredYou don't need to write Python scrapers or manage Selenium/Puppeteer instances. The MCP server handles proxying, live Google SERP extraction, and DOM analysis natively.
MCP Execution Stream — Cursor IDE
Connected
User Prompt: "Read my local blog file landing-page.tsx, then run a live AEO audit via AI Rank Lab MCP and rewrite the meta & schema tags directly in my file."
Agent Execution Steps:
1.Cursor connects to https://www.airanklab.com/api/v1/mcp
2.Executes run_url_audit(url: "https://mysite.com")
3.Receives JSON audit payload: missing JSON-LD schema & low H2 keyword density
4.Applies code fixes directly inside landing-page.tsx
Result ready in editorEndpoint: /api/v1/mcp
Built-in Tool Ecosystem

12+ Production-Ready SEO Tools via MCP

Every tool available in our developer API is automatically callable by your MCP agent with strict schema validation and pre-flight credit estimates.

run_url_audit

Full SEO + AEO + GEO Page Audit

Comprehensive analysis of any web page — technical health, Core Web Vitals, Schema markup, and AI Engine Optimization (AEO) readiness.

Sample Prompt:"Run a full AEO and technical SEO audit on https://example.com/blog/ai-tools and give me a prioritized fix list."
Inputs: url: string, depth?: string
Outputs: SEO score, AEO score, GEO recommendations, critical fixes list
check_ai_brand_visibility

AI Search & LLM Citation Audit

Queries ChatGPT (GPT-4o), Claude 3.5, Gemini 1.5, and Perplexity to see if your brand is recommended for buyer queries vs. competitors.

Sample Prompt:"Check if ChatGPT and Gemini cite our brand when asked: what is the best AI rank tracker software?"
Inputs: brand: string, domain: string, query: string
Outputs: Mention percentage, citation URLs, competitor gap analysis
search_keywords

Keyword Universe & SERP Intent

Pulls live search volumes, keyword difficulty (KD), CPC, SERP features (AI Overviews, PAA, Featured Snippets), and topic clusters.

Sample Prompt:"Search keywords related to generative engine optimization and build a list sorted by volume and low difficulty."
Inputs: query: string, country?: string
Outputs: Keyword metrics array, difficulty score, SERP features, related terms
get_bot_visits

AI Bot Visit Logs (GPTBot, ClaudeBot)

Logs and reports how often AI engine crawlers (GPTBot, ClaudeBot, PerplexityBot, Bytespider) visit your website pages.

Sample Prompt:"Fetch the bot visit logs for my domain over the last 14 days and show which pages GPTBot crawled most."
Inputs: domain: string, timeframe?: string
Outputs: Bot hit counts, top crawled URLs, crawler breakdown chart data
generate_llms_txt

llms.txt & llms-full.txt Generator

Generates standard /llms.txt files that structure your site content specifically for LLM scraping and AI citations.

Sample Prompt:"Audit my website pages and generate a production-ready /llms.txt file to help AI models cite our product docs."
Inputs: domain: string, includeFull?: boolean
Outputs: Formatted markdown /llms.txt and /llms-full.txt code content
core_web_vitals

Core Web Vitals & PageSpeed Scan

Executes Google PageSpeed Insights scans for mobile and desktop, returning exact LCP, CLS, FID, and performance opportunities.

Sample Prompt:"Check the Core Web Vitals for my landing page on mobile and tell me what is causing LCP delay."
Inputs: url: string, strategy?: "mobile" | "desktop"
Outputs: Performance score, Core Web Vitals pass/fail, diagnostics list
get_page_citations

Live AI Citation & Source Tracker

Retrieves active citations across ChatGPT, Perplexity, and Gemini search answers with source link verification.

Sample Prompt:"Fetch all live AI citations for our pricing page and show which queries bring Perplexity users to us."
Inputs: domain: string, targetKeyword?: string
Outputs: Citation count, AI Engine source URLs, sentiment rating
generate_schema_markup

AI-Ready Schema.org JSON-LD Generator

Builds validated Organization, Product, Article, FAQ, and HowTo JSON-LD schemas optimized for AI search parsers.

Sample Prompt:"Generate an FAQ JSON-LD schema markup for our top 5 product questions to place on our homepage."
Inputs: type: "article" | "product" | "faq", data: object
Outputs: Validated JSON-LD schema snippet string
analyze_competitor_gaps

Competitor AEO & Keyword Gap Matrix

Compares your website against up to 3 competitors to uncover missing keywords, AI Overview opportunities, and backlink gaps.

Sample Prompt:"Compare our domain against competitorA.com and competitorB.com to find keywords where they rank in Google AI Overviews."
Inputs: myDomain: string, competitors: string[]
Outputs: Shared keywords, missing high-intent terms, AI gap score
get_search_console_queries

GSC AI Cannibalization & Decay Detector

Connects to Google Search Console to detect decaying pages, CTR anomalies, and internal keyword cannibalization.

Sample Prompt:"Identify all blog pages on our site that lost more than 20% impressions in Search Console over the last month."
Inputs: domain: string, timeframe?: string
Outputs: Decaying URLs list, low-CTR keywords, cannibalization alerts
get_ga4_ai_traffic

GA4 AI Bot Referral Traffic Analyzer

Analyzes GA4 analytics data for referral traffic originating from ChatGPT, Claude, Perplexity, and Meta AI.

Sample Prompt:"Show GA4 referral traffic coming from ChatGPT and Perplexity over the past 30 days and top landing pages."
Inputs: propertyId: string, timeframe?: string
Outputs: AI referral visitor count, conversion rate, top landing pages
generate_ai_content_brief

AI Content Brief & Outline Generator

Creates exhaustive content briefs with heading structures (H2/H3), semantic LSI keywords, and entity definitions designed for AEO.

Sample Prompt:"Generate a comprehensive AI content brief targeting the keyword Model Context Protocol for SEO."
Inputs: topic: string, targetPersona?: string
Outputs: Markdown content brief with outline, entity list, target word count
High Performance Infrastructure

Built for AI Agent Scale & Agency Security

How AI Rank Lab's managed MCP server compares to legacy APIs and custom scrapers.

Feature / CapabilityAI Rank Lab MCPLegacy SEO APIs (Ahrefs/Semrush)Custom Scrapers (Puppeteer)
Protocol StandardNative MCP (Streamable HTTP)REST (Requires custom glue code)None (Raw DOM)
AI Brand & LLM CitationsYes (ChatGPT, Claude, Gemini)NoUnreliable (Blocked by Cloudflare)
Monthly Subscriptions$0 Mandatory Fee (Universal Credits)$500 - $1,200 / monthHigh proxy & server costs
Pre-flight Cost SafetyBuilt-in (Estimates upfront)No (Overages billed directly)N/A
IDE Integration (Cursor/Claude)1-Command AddComplex wrapper requiredRequires local subprocesses
UNIVERSAL CREDIT BILLING

Transparent Pay-As-You-Go MCP Rates

MCP calls authenticate using your standard API key and deduct from your account's universal monthly credit balance. Zero hidden fees.

audit_url

Run a full AEO/SEO audit of a URL

50credits / call
keyword_research

Keyword volume, difficulty and ideas

50credits / call
core_web_vitals

Core Web Vitals / PageSpeed scan

25credits / call
brand_visibility

Ask a live AI engine about a brand

per engine

100credits / call
generate_faq

Generate an FAQ for a page

20credits / call
generate_llms_txt

Generate an llms.txt manifest

20credits / call
FAQ

Frequently Asked Questions

Everything you need to know about setting up and calling AI Rank Lab over MCP.

Model Context Protocol (MCP) is an open standard developed by Anthropic that lets AI clients (such as Claude Code, Cursor, Windsurf, or custom Python scripts) securely connect to external tools and data sources. Instead of writing custom API code for every tool, MCP lets the AI natively discover and execute functions directly within a chat or terminal session.

Ready to power your AI Agents with Search Intelligence?

Generate your API key in seconds and connect Claude Code, Cursor, or your custom agent framework today.