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.

GitHubPrueba este MCPPatrocinado

Documentación

AirROI Airbnb MCP Server

Datos de mercado de alquileres a corto plazo para asistentes de IA · Remoto · HTTP Streamable · com.airroi/mcp

El servidor MCP de Airbnb de AirROI ofrece a Claude, Codex, Cursor, VS Code y cualquier otro cliente del Model Context Protocol 29 herramientas para datos de mercado de Airbnb y alquileres a corto plazo: ocupación, ADR, RevPAR, percentiles de ingresos, comparables, estimaciones de ingresos, calendarios en vivo de Airbnb y ranking de búsqueda, y recomendaciones de precios. Cubre más de 20 millones de anuncios en más de 190 países y responde desde un conjunto de datos mantenido, por lo que tu asistente nunca extrae datos de airbnb.com.

Este repositorio es solo documentación. El servidor es completamente remoto en https://mcp.airroi.com; no hay nada que instalar o ejecutar. AirROI es un proveedor de datos independiente y no está afiliado a Airbnb. A partir de septiembre de 2026, Airbnb no tiene un servidor MCP oficial ni una API pública.


Endpoint	`https://mcp.airroi.com`
Transporte	HTTP Streamable (remoto)
Autenticación	Cabecera `X-API-KEY`, requerida en cada solicitud
Herramientas	29 (11 de mercado, 13 de anuncios, 3 de búsqueda y estimación, 2 de precios)
Precio	Desde $0.01 por llamada, pago por uso
Registro	`com.airroi/mcp` en el Registro MCP oficial
Documentación	https://www.airroi.com/mcp-server

¿Qué servidor MCP de Airbnb necesitas?

"Servidor MCP de Airbnb" puede significar tres cosas diferentes. Elige según la tarea:

Quieres…	Tipo de servidor	Ejemplos	¿AirROI?
Encontrar un lugar para alojarte	Scraper de búsqueda de anuncios	Apify, Bright Data	No
Gestionar tus propios anuncios (mensajes, reservas, calendarios)	Servidor de gestión de propiedades	Hospitable, Guesty	No
Analizar un mercado, una propiedad o un conjunto comparable	MCP de datos de mercado	AirROI	Sí

Una comparación lado a lado con precios y limitaciones: https://www.airroi.com/mcp-server/compare

Obtén una clave de API

Regístrate para obtener una clave de API gratuita en https://www.airroi.com/api
Actívala en el panel de desarrollador en https://www.airroi.com/api/developer/activate y copia la clave.
Úsala como valor de la cabecera X-API-KEY en los fragmentos a continuación. Reemplaza solo YOUR_API_KEY.

Descubrir herramientas (tools/list) no se factura, pero cada solicitud necesita la clave.

Configuración

Guías completas por cliente: Claude · Codex y ChatGPT · cualquier otro cliente

Claude Code

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

Compruébalo con claude mcp get airroi y luego hazle a Claude una pregunta de mercado.

Claude Desktop

Claude Desktop se conecta a servidores remotos con cabeceras personalizadas a través del puente mcp-remote (necesita Node.js). Edita ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows) y luego reinicia la aplicación:

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

Mantén X-API-KEY:${AIRROI_API_KEY} sin espacios alrededor de los dos puntos.

Codex (CLI, extensión de IDE y aplicación de escritorio de ChatGPT)

Los tres leen ~/.codex/config.toml:

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

Luego export AIRROI_API_KEY=YOUR_API_KEY en tu perfil de shell. codex mcp list muestra Auth: Unsupported para autenticación por cabecera; eso es esperado. ChatGPT en la web (modo desarrollador) no admite servidores con clave de API, así que usa Codex.

Cursor

~/.cursor/mcp.json (global) o .cursor/mcp.json (proyecto):

{
  "mcpServers": {
    "airroi": {
      "url": "https://mcp.airroi.com",
      "headers": { "X-API-KEY": "${env:AIRROI_API_KEY}" }
    }
  }
}

VS Code (modo agente de Copilot)

.vscode/mcp.json. La clave de nivel superior es servers, no mcpServers:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "airroi-key",
      "description": "AirROI API key",
      "password": true
    }
  ],
  "servers": {
    "airroi": {
      "type": "http",
      "url": "https://mcp.airroi.com",
      "headers": { "X-API-KEY": "${input:airroi-key}" }
    }
  }
}

Devin Desktop (anteriormente Windsurf)

~/.config/devin/mcp_config.json (Windows: %APPDATA%\devin\mcp_config.json):

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

CLI de Antigravity (sucesor de Gemini CLI)

~/.gemini/config/mcp_config.json (global) o .agents/mcp_config.json (proyecto):

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

n8n

Añade un nodo AI Agent y luego adjúntale un nodo MCP Client Tool.
Establece el endpoint en https://mcp.airroi.com y el transporte en HTTP Streamable.
Elige Header Auth y crea una credencial con el nombre X-API-KEY y tu clave como valor.

OpenAI Agents SDK (Python)

import asyncio, os
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async def main():
    async with MCPServerStreamableHttp(
        name="airroi",
        params={
            "url": "https://mcp.airroi.com",
            "headers": {"X-API-KEY": os.environ["AIRROI_API_KEY"]},
        },
    ) as airroi:
        agent = Agent(name="STR analyst", mcp_servers=[airroi])
        result = await Runner.run(
            agent, "Occupancy and ADR for 2-bedroom homes in Nashville?"
        )
        print(result.final_output)

asyncio.run(main())

Cualquier cliente solo-stdio

npx mcp-remote https://mcp.airroi.com --header X-API-KEY:${AIRROI_API_KEY}

Una sesión real

Solicitud, ejecutada contra el servidor en vivo en mcp.airroi.com:

Compara Austin y Nashville para un Airbnb de casa completa de 2 dormitorios: ocupación, ADR, RevPAR, ingresos anuales y cuántos anuncios competidores enfrentaría.

Llamadas a herramientas: airroi_search_markets → airroi_search_markets → airroi_market_summary → airroi_market_summary → airroi_market_revenue → airroi_market_revenue (costo $0.42)

En los últimos 12 meses, las casas completas de 2 dormitorios en Nashville ganaron más por anuncio: $40,075 en ingresos anuales promedio frente a $24,965 en Austin. La ocupación es casi idéntica (49% frente a 48%), por lo que la brecha proviene de la tarifa: el ADR de Nashville es de $296 frente a los $236 de Austin, con un RevPAR de $146 frente a $114. Nashville también tiene menos oferta de 2 dormitorios, alrededor de 1,270 anuncios activos al mes frente a unos 2,029 en Austin. Octubre de 2025 fue el mes más fuerte para el anuncio mediano en ambos mercados, con $5,009 en Nashville y $3,941 en Austin.

Más sesiones (ranking de búsqueda en vivo, informes de propietarios, ritmo futuro, Lisboa): https://www.airroi.com/mcp-server/use-cases

Herramientas (29)

Ninguna herramienta puede cambiar un anuncio, precio, reserva o mensaje. 26 herramientas están marcadas como de solo lectura; las otras 3 crean un archivo de descarga o un cursor de escaneo.

Analítica de mercado (11)

Herramienta	Qué hace	Precio por llamada
`airroi_market_min_nights`	Rastrea los ajustes mensuales promedio de noches mínimas y desgloses percentiles en un mercado. Úsalo para comprender las restricciones locales de estancia junto con las tendencias de ocupación y precios.	$0.10
`airroi_market_summary`	Obtén una visión general rápida del mercado con estadísticas clave: ocupación, ADR, RevPAR, ingresos anuales promedio por anuncio, tiempo de anticipación de reserva, duración de la estancia, noches mínimas y recuento de anuncios activos. Devuelve una instantánea de un solo respuesta de los últimos 12 meses de cualquier mercado.	$0.10
`airroi_market_metrics_all`	Accede a todas las métricas de mercado combinadas en una sola respuesta. Devuelve series temporales mensuales con desgloses percentiles (promedio, p25, p50, p75, p90) para ocupación, ADR, RevPAR, ingresos, tiempo de anticipación, duración de la estancia, noches mínimas y anuncios activos: la herramienta única más completa.	$0.50
`airroi_market_occupancy`	Rastrea tendencias históricas y estacionales de la tasa de ocupación con datos de series temporales mensuales. Devuelve promedios y desgloses percentiles para identificar períodos de demanda máxima y patrones de reserva.	$0.10
`airroi_market_adr`	Analiza las tendencias de la Tarifa Diaria Promedio con series temporales mensuales y desgloses percentiles. Rastrea la compresión de precios, las fluctuaciones estacionales y el crecimiento de tarifas en todo un mercado.	$0.10
`airroi_market_revpar`	Monitorea los Ingresos por Alquiler Disponible combinando ocupación y precios en una métrica de rendimiento única. Devuelve series temporales mensuales con distribuciones percentiles para benchmarking.	$0.10
`airroi_market_revenue`	Rastrea los ingresos mensuales de anuncios con series temporales y desgloses percentiles. Analiza las tendencias de crecimiento de ingresos y los patrones estacionales para dimensionar oportunidades de inversión.	$0.10
`airroi_market_lead_time`	Comprende con cuánta anticipación reservan los huéspedes en cualquier mercado, medido en días. Devuelve series temporales mensuales con percentiles para optimizar estrategias de precios y tiempos de marketing.	$0.10
`airroi_market_los`	Analiza los patrones promedio de duración de estancia de los huéspedes medidos en noches. Devuelve series temporales mensuales con desgloses percentiles para planificación operativa y optimización de estancias mínimas.	$0.10
`airroi_market_active_listings`	Monitorea el crecimiento de la oferta del mercado rastreando los recuentos de anuncios activos a lo largo del tiempo. Identifica nuevos participantes, saturación del mercado y cambios en el panorama competitivo con datos de series temporales mensuales.	$0.10
`airroi_market_future_pacing`	Accede al ritmo de reservas prospectivo para fechas futuras. Devuelve datos diarios de ritmo con recuento de reservados, recuento de disponibles, tarifas promedio y tasa de ocupación para pronóstico de demanda y predicción de ingresos.	$0.20

Búsqueda de mercado y estimaciones de ingresos (3)

Herramienta	Qué hace	Precio por llamada
`airroi_search_markets`	Busca mercados de alquiler a corto plazo por nombre con coincidencia de prefijo. Devuelve los identificadores exactos del mercado (país, región, localidad, distrito) con recuentos de anuncios activos necesarios para todas las herramientas de mercado.	$0.01
`airroi_lookup_market`	Resuelve coordenadas GPS brutas a los identificadores exactos del mercado (país, región, localidad, distrito) que requiere cada herramienta de mercado. Lo contrario de search_markets: úsalo cuando tengas una latitud/longitud en lugar de un nombre de lugar.	$0.01
`airroi_estimate_revenue`	Genera proyecciones de ingresos para cualquier ubicación basadas en dormitorios, baños y capacidad de huéspedes. Devuelve ingresos anuales proyectados, ADR, ocupación con desgloses percentiles (p25-p90), distribución mensual y anuncios comparables.	$0.20

Datos de anuncios (4)

Herramienta	Qué hace	Precio por llamada
`airroi_get_listing`	Recupera datos completos de un anuncio de Airbnb por ID: detalles de la propiedad, texto de descripción, URLs de fotos, horarios de entrada y salida, estado de favorito de huéspedes, precios, calificaciones y métricas de rendimiento, incluidos ocupación, ADR e ingresos de los últimos 12 meses y los últimos 90 días.	$0.10
`airroi_batch_listings`	Obtén información detallada de hasta 25 propiedades en una sola solicitud facturada. Devuelve recuentos y un recurso JSON descargable que contiene detalles completos de las propiedades y cualquier error por ID. Descargar el recurso no repite la llamada a la API.	$1.00
`airroi_find_comparables`	Descubre hasta 25 propiedades similares clasificadas por relevancia según ubicación, dormitorios, baños y capacidad de huéspedes. Especifica la ubicación mediante coordenadas o una dirección física, y opcionalmente un radio de 1 a 10 millas y tipo de habitación, para benchmarking competitivo.	$0.10
`airroi_listing_metrics`	Accede hasta 60 meses de datos históricos de rendimiento por anuncio: ocupación mensual, ADR, RevPAR, ingresos y ajuste promedio de noches mínimas. Ideal para análisis de tendencias, detección de estacionalidad y suscripción de inversiones.	$0.10

Búsqueda y exportación de anuncios (4)

Herramienta	Qué hace	Precio por llamada
`airroi_search_by_market`	Busca anuncios activos dentro de una ciudad, región o vecindario usando definiciones de mercado de OpenStreetMap, o globalmente cuando no se da un mercado. Filtra por atributos de propiedad, detalles del anfitrión, precios, calificaciones y métricas de rendimiento; devuelve hasta 10 resúmenes compactos por llamada.	$0.50
`airroi_search_by_radius`	Encuentra propiedades dentro de un radio de 1 a 100 millas de cualquier coordenada GPS. Admite el mismo filtrado y ordenamiento que la búsqueda de mercado para análisis competitivo basado en ubicación; devuelve hasta 10 resúmenes compactos por llamada.	$0.50
`airroi_search_by_polygon`	Busca anuncios dentro de límites geográficos personalizados definidos por 3 o más puntos de coordenadas. Dibuja cualquier forma para definir tu área de búsqueda para segmentación de mercado precisa y análisis de vecindarios; devuelve hasta 10 resúmenes compactos por llamada.	$0.50
`airroi_export`	Exporta cada anuncio que coincida con un selector de mercado, radio o polígono personalizado a un único archivo descargable, entregado como una URL de descarga prefirmada válida por 7 días. El conjunto de datos completo nunca se transmite a la conversación: obtienes metadatos, una vista previa breve y el enlace de descarga para guardar localmente. Elige JSONL (un objeto de anuncio anidado completo por línea) o CSV (columnas de resumen aplanadas). La paginación se maneja internamente hasta un límite de 100,000 anuncios; las exportaciones muy grandes devuelven un archivo parcial con recuentos si se alcanza el presupuesto de tiempo. Ideal para análisis masivo, canalizaciones de datos y scripting sin conexión.	$0.50 (1 llamada por cada 10 anuncios)

Datos en vivo de Airbnb (5)

Herramienta	Qué hace	Precio por llamada
`airroi_live_calendar`	Obtén el calendario de un anuncio en vivo desde Airbnb: tarifas nocturnas (excluyendo la tarifa de limpieza), disponibilidad y estancias mínimas para los próximos 12 meses, además de la tarifa de limpieza del anfitrión y la tarifa de limpieza para estancias cortas. Las noches reservadas y bloqueadas por el anfitrión aparecen como no disponibles.	$0.20
`airroi_live_rates`	Obtén solo las tarifas nocturnas de un anuncio en vivo para los próximos 12 meses, en moneda local o en dólares estadounidenses. Úsalo para el seguimiento de precios de competidores cuando no se necesite la disponibilidad.	$0.10
`airroi_live_availability`	Obtén la disponibilidad y las reglas de estancia de un anuncio en vivo para los próximos 12 meses: noches abiertas o no disponibles, estancia mínima y máxima, y si los huéspedes pueden registrarse o salir en cada fecha.	$0.10
`airroi_live_search_ranking`	Consulta los anuncios que Airbnb muestra en la búsqueda para un rectángulo en el mapa, en orden de clasificación (hasta 270). Úsalo para ver dónde aparece un anuncio en la búsqueda frente a sus competidores.	$0.20
`airroi_live_scan`	Encuentra cada ID de anuncio de Airbnb dentro de un polígono personalizado, en vivo, hasta 100 IDs por página. Continúa con el scan_id corto que devuelve; el servidor mantiene el progreso del escaneo, por lo que cada página se mantiene pequeña. Combínalo con get_listing o batch_listings para obtener detalles completos.	$0.50

Recomendaciones de precios (2)

Herramienta	Qué hace	Precio por llamada
`airroi_recommend_base_price`	Estima un precio nocturno inicial para todo el año a partir de las coordenadas de la propiedad y hechos conocidos de la misma. Las comodidades opcionales, reseñas y otros detalles pueden refinar la estimación. Nada se guarda ni se publica.	$0.10
`airroi_recommend_calendar_prices`	Calcula precios nocturnos a partir de coordenadas, moneda y un precio base. La estacionalidad modelada, los días de semana, eventos y la demanda se combinan con reglas de precios opcionales, ajustes estacionales, límites de precio y restricciones de estancia.	$0.10

Referencia completa con parámetros: https://www.airroi.com/mcp-server/tools

Cuánto cuesta una consulta

Un análisis de mercado típico requiere seis llamadas:

Llamada	Precio
`airroi_search_markets`	$0.01
`airroi_market_summary`	$0.10
`airroi_market_occupancy`	$0.10
`airroi_market_adr`	$0.10
`airroi_market_revenue`	$0.10
`airroi_market_future_pacing`	$0.20
Total	$0.61

Lista de precios: https://www.airroi.com/api/pricing

Cobertura de datos

Más de 20 millones de anuncios en más de 190 países y más de 30,000 mercados
Ocupación mensual, ADR, RevPAR e ingresos con percentiles p25/p50/p75/p90, hasta 60 meses por solicitud
Calendarios de Airbnb en vivo, tarifas, disponibilidad y clasificación en búsquedas, hasta 12 meses por adelantado
Monedas locales, o USD a solicitud

Enlaces

Descripción general del servidor MCP de Airbnb: https://www.airroi.com/mcp-server
Conecta Claude a los datos de Airbnb: https://www.airroi.com/mcp-server/claude
Conecta Codex y ChatGPT a los datos de Airbnb: https://www.airroi.com/mcp-server/codex
Comparativa de los mejores servidores MCP de Airbnb: https://www.airroi.com/mcp-server/compare
Configuración para cada cliente: 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 (mismos datos, misma clave): https://www.airroi.com/api

Licencia

MIT, consulta LICENSE.