AirROI

Análisis de mercado de Airbnb y alquileres a corto plazo: ocupación, ADR, RevPAR, ingresos, comparables y estimaciones de ingresos por ML para más de 30,000 mercados en todo el mundo, respaldado por más de 20 millones de anuncios rastreados.

GitHub

Documentación

AirROI MCP Server

Oficial · Remoto · Streamable HTTP · com.airroi/mcp

Servidor MCP oficial de AirROI — analítica de mercado para Airbnb y alquileres a corto plazo: ocupación, ADR, RevPAR, ingresos, comparables y estimaciones de ingresos por ML en más de 30 000 mercados en todo el mundo, respaldado por más de 20 millones de listados rastreados. Servidor remoto en https://mcp.airroi.com (Streamable HTTP, autenticación X-API-KEY, clave en airroi.com).

Este repositorio es solo documentación. El servidor es totalmente remoto — no hay nada que instalar, compilar o ejecutar localmente. Apunta cualquier cliente MCP a https://mcp.airroi.com con una cabecera X-API-KEY.


Endpoint	`https://mcp.airroi.com`
Transporte	Streamable HTTP
Autenticación	Cabecera `X-API-KEY`
Nombre del registro	`com.airroi/mcp`
Obtén una clave API	https://www.airroi.com/api
Herramientas	22

Obtén una clave API

Regístrate en https://www.airroi.com/api
Activa el Developer Dashboard en https://www.airroi.com/api/developer/activate
Copia tu clave y úsala como valor de la cabecera X-API-KEY en los fragmentos siguientes.

Reemplaza solo YOUR_API_KEY en los fragmentos — mantén el nombre de la cabecera X-API-KEY exactamente como está escrito.

Configuración

Claude Code

claude mcp add --transport http airroi https://mcp.airroi.com \
  --header "X-API-KEY: YOUR_API_KEY"

Verifica con /mcp en una sesión nueva, o claude mcp list.

Claude Desktop

Claude Desktop se conecta a través del puente mcp-remote (requiere Node.js). Abre Settings → Developer → Edit Config para editar claude_desktop_config.json:

{
  "mcpServers": {
    "airroi": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.airroi.com",
        "--header",
        "X-API-KEY: YOUR_API_KEY"
      ]
    }
  }
}

Cursor

Edita ~/.cursor/mcp.json (a nivel de usuario) o .cursor/mcp.json (a nivel de proyecto), o usa Settings → Features → MCP → + Add New MCP Server:

{
  "mcpServers": {
    "airroi": {
      "type": "streamable-http",
      "url": "https://mcp.airroi.com",
      "headers": {
        "X-API-KEY": "YOUR_API_KEY"
      }
    }
  }
}

VS Code (GitHub Copilot)

Requiere VS Code 1.99+ y la extensión Copilot. Crea .vscode/mcp.json en la raíz de tu proyecto, o ejecuta MCP: Open User Configuration desde la paleta de comandos. Ten en cuenta que VS Code usa "servers" como clave raíz (no "mcpServers"):

{
  "servers": {
    "airroi": {
      "type": "http",
      "url": "https://mcp.airroi.com",
      "headers": {
        "X-API-KEY": "YOUR_API_KEY"
      }
    }
  }
}

Cline

Abre MCP Servers → Configure MCP Servers en Cline y añade:

{
  "mcpServers": {
    "airroi": {
      "type": "streamableHttp",
      "url": "https://mcp.airroi.com",
      "headers": {
        "X-API-KEY": "YOUR_API_KEY"
      }
    }
  }
}

Consulta llms-install.md para la instalación guiada por agente.

Codex

Codex usa TOML en ~/.codex/config.toml (a nivel de usuario) o .codex/config.toml (a nivel de proyecto):

[mcp_servers.airroi]
url = "https://mcp.airroi.com"
http_headers = { "X-API-KEY" = "YOUR_API_KEY" }

Gemini CLI

Edita ~/.gemini/settings.json (a nivel de usuario) o .gemini/settings.json (a nivel de proyecto). Gemini CLI usa httpUrl (no url) para transporte HTTP streamable:

{
  "mcpServers": {
    "airroi": {
      "httpUrl": "https://mcp.airroi.com",
      "headers": {
        "X-API-KEY": "YOUR_API_KEY"
      }
    }
  }
}

Windsurf

Edita ~/.codeium/windsurf/mcp_config.json o usa Settings → Plugins. Windsurf usa serverUrl en lugar de url:

{
  "mcpServers": {
    "airroi": {
      "serverUrl": "https://mcp.airroi.com",
      "headers": {
        "X-API-KEY": "YOUR_API_KEY"
      }
    }
  }
}

Cualquier otro cliente MCP

Transport: HTTP (Streamable HTTP)
URL: https://mcp.airroi.com
Headers:
  X-API-KEY: YOUR_API_KEY

El servidor es totalmente remoto — no se requieren SDK locales ni procesos.

Herramientas (22)

Herramientas de listados (9)

Herramienta	Descripción
`airroi_get_listing`	Obtén datos completos de la propiedad, incluyendo comodidades, reseñas, precios, detalles del anfitrión y análisis de rendimiento en tiempo real
`airroi_batch_listings`	Recupera información detallada de hasta 25 propiedades en una sola solicitud
`airroi_find_comparables`	Descubre hasta 25 propiedades similares ordenadas por relevancia según ubicación, dormitorios, baños y capacidad de huéspedes
`airroi_listing_metrics`	Accede a hasta 60 meses de datos históricos de rendimiento por listado: ocupación mensual, ADR, RevPAR e ingresos
`airroi_listing_future_rates`	Consulta hasta 365 días de tarifas nocturnas futuras y estado de disponibilidad de cualquier propiedad
`airroi_search_by_market`	Busca todos los listados activos dentro de los límites de una ciudad o vecindario usando definiciones de mercado de OpenStreetMap
`airroi_search_by_radius`	Encuentra todas las propiedades dentro de un radio de 1 a 100 millas desde cualquier coordenada GPS
`airroi_search_by_polygon`	Busca listados dentro de límites geográficos personalizados definidos por 3 o más puntos de coordenadas
`airroi_export`	Exporta todos los listados que coincidan con un selector de mercado, radio o polígono personalizado a un archivo descargable

Herramientas de mercado (10)

Herramienta	Descripción
`airroi_market_summary`	Obtén una visión general rápida del mercado con estadísticas clave: ocupación, ADR, RevPAR, ingresos, plazo de reserva, duración de la estancia y número de listados activos
`airroi_market_metrics_all`	Accede a todas las métricas de mercado combinadas en una sola respuesta con series temporales mensuales y desgloses percentiles
`airroi_market_occupancy`	Sigue las tendencias históricas y estacionales de la tasa de ocupación con datos de series temporales mensuales
`airroi_market_adr`	Analiza las tendencias de la tarifa diaria promedio con series temporales mensuales y desgloses percentiles
`airroi_market_revpar`	Supervisa los ingresos por alquiler disponible combinando ocupación y precios en una única métrica de rendimiento
`airroi_market_revenue`	Sigue la generación total de ingresos del mercado con series temporales mensuales y desgloses percentiles
`airroi_market_lead_time`	Comprende con cuánta antelación reservan los huéspedes en cualquier mercado, medido en días
`airroi_market_los`	Analiza los patrones de duración media de la estancia de los huéspedes, medidos en noches
`airroi_market_active_listings`	Supervisa el crecimiento de la oferta del mercado mediante el seguimiento del número de listados activos a lo largo del tiempo
`airroi_market_future_pacing`	Accede al ritmo de reservas prospectivo para fechas próximas con datos diarios de ritmo

Herramientas de utilidad (3)

Herramienta	Descripción
`airroi_search_markets`	Busca mercados de alquiler a corto plazo por nombre con coincidencia de prefijo
`airroi_lookup_market`	Convierte coordenadas GPS en los identificadores de mercado exactos que requieren todas las herramientas de mercado
`airroi_estimate_revenue`	Genera proyecciones de ingresos para cualquier ubicación según dormitorios, baños y capacidad de huéspedes

Referencia completa: https://www.airroi.com/mcp-server/tools

Ejemplos de consultas

Una vez conectado, pregunta en lenguaje natural:

"¿Cuál es la ocupación media y el ADR de los alquileres a corto plazo en Austin, Texas, en los últimos 12 meses?"
"Estima los ingresos anuales de un Airbnb de 3 dormitorios y 2 baños para 6 huéspedes en Joshua Tree, CA."
"Encuentra 10 listados comparables al listado de Airbnb 12345678 y compara su RevPAR."
"¿Qué vecindarios de Lisboa tienen el RevPAR más alto y cómo ha crecido la oferta allí en los últimos dos años?"
"Muéstrame el ritmo de reservas prospectivo de Scottsdale para los próximos 90 días — ¿vamos por delante o por detrás del año pasado?"

Cobertura de datos

Más de 20 millones de propiedades rastreadas
Más de 30 000 mercados en más de 190 países
Más de 15 años de datos históricos
Hasta 60 meses de historial de listados, 365 días de tarifas futuras

Más información: https://www.airroi.com/api/data-coverage

Enlaces

Descripción general del servidor MCP — https://www.airroi.com/mcp-server
Guía de configuración — https://www.airroi.com/mcp-server/setup
Referencia de herramientas — https://www.airroi.com/mcp-server/tools
Casos de uso — https://www.airroi.com/mcp-server/use-cases
API REST — https://www.airroi.com/api
Contacto — https://www.airroi.com/contact

Licencia

MIT — consulta LICENSE.