Herramientas de AI Rank Lab, dentro de tu agente de IA
El servidor MCP de AI Rank Lab expone las mismas herramientas que la API para desarrolladores — el verificador completo de SEO + AEO + GEO, búsqueda en vivo de Google, consultas de AI Overview y AI Mode para cualquier país y dispositivo, investigación de palabras clave, Core Web Vitals, verificaciones de visibilidad de marca con IA, generación de FAQ y llms.txt, además de tus datos de Google Analytics 4, Search Console, visitas de bots y citas — a través del Protocolo de Contexto del Modelo. Añádelo a Claude Code, Claude Desktop o Cursor y tu agente podrá ejecutarlos directamente.
Introducción
The Protocolo de Contexto del Modelo (MCP) is an open standard that lets AI assistants call external tools. Our MCP server is a thin layer over the /api/v1 API REST: 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 HTTP con capacidad de transmisión transport in stateless mode, so there is nothing to install or host — you point your client at the endpoint with your API credentials.
Endpoint y autenticación
El servidor reside en un único endpoint:
POST https://www.airanklab.com/api/v1/mcpEvery request must carry the same two headers as the REST API: x-api-key and x-api-secret. Generate both from Panel de control → API e integraciones.
La configuración de tu cliente MCP almacena el secreto en texto plano en tu máquina. Mantén el archivo de configuración fuera del control de versiones y rota el par de claves desde el panel de control si alguna vez se filtra.
Claude.ai (Aplicación web)
To connect the MCP server directly in the Claude.ai web interface, open the Añadir conector personalizado 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 del servidor MCP remoto 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_SECRETDebido a que Claude.ai no soporta encabezados personalizados, debes incluir tus credenciales en los parámetros de consulta de la URL. Ten en cuenta que esto puede hacer que aparezcan en nuestros registros de acceso del servidor.
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
Un comando añade el servidor a Claude Code (CLI v1.x o posterior):
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 “ejecuta el chequeo SEO + AEO + GEO en
example.com y resume los problemas críticos” or “¿a quién
cita la Visión General de IA de Google por ‘mejor CRM para startups’ en India en
móvil?” — it will call the seo-aeo-geo-audit and google-ai-overview tools for you.
Claude Desktop
Add this to your Claude Desktop configuration (Ajustes → Desarrollador → Editar
Configuración, 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"
}
}
}
}Herramientas disponibles y precios
Las herramientas MCP replican los endpoints de las herramientas REST uno a uno y gastan el mismo saldo de crédito — una herramienta cuesta lo mismo ya sea que la llames desde el panel, la API REST o MCP. Las lecturas de datos son gratuitas; las llamadas a herramientas fallidas se reembolsan automáticamente.
The three Google tools (google-search, google-ai-overview, google-ai-mode) take a país and a dispositivo— name the country (“India”), its ISO code (“IN”) or its numeric location code (2356), and pick escritorio or móvil. 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, dominios-de-referencia, texto-ancla, autoridad-de-dominio-masiva) work on cualquieradomain, not just the ones registered on your account, so an agent can research a competitor’s link profile directly. The free filtros-de-backlinks tool lists the presets, modes and fields the filtered backlink queries accept.
| Herramienta | Descripción | Créditos por llamada |
|---|---|---|
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 |
Herramientas de larga duración
Heavier tools (audits, brand visibility) normally finish within the request. Each call has a Presupuesto de 120 segundos: if the work isn't done in time, the tool returns a ID de trabajo with polling instructions instead of the result.
Poll GET /api/v1/jobs/{jobId} (REST, same headers) until the status is completado — see Tareas asíncronas in the API reference.
Límites de velocidad
MCP requests count against the same per-key limit as the REST API: 60 solicitudes por minuto by default. A 429 response includes Retry-After. Need a higher limit? Contáctanos.
Conecta tu agente
Genera tu clave y secreto de API, pega un bloque de configuración, y tu agente de IA podrá ejecutar herramientas de marketing reales.
Get your API key