AirROI Airbnb MCP Server

com.airroi由 airroi.com 发布官方发布者v1.0.1更新于 Oct 25, 2026

Airbnb MCP server for short-term rental data: occupancy, ADR, RevPAR, revenue, comps, live rates

已验证Streamable HTTP可网页运行位置与生活金融数据与分析

概览

AI 生成的概览

远程 AirROI 服务器，让助手获取 Airbnb 短租市场数据：入住率、ADR、RevPAR、收入、可比房源和实时价格。

可以做什么
按名称或 GPS 坐标搜索和解析市场，并按卧室、浴室和可住人数估算某地点的收入。获取市场分析：入住率、ADR、RevPAR、收入、预订提前期、入住时长、最短入住、活跃房源和未来预订节奏，含分位数细分。查询单个房源、批量查询最多 25 个、查找可比房源，并读取最多 60 个月的房源指标。按市场、半径或多边形搜索房源，并将匹配房源导出为可下载文件。获取 Airbnb 实时日历、价格、可订状态、搜索排名和多边形扫描。根据房源信息推荐基础每晚价格和日历价格。
适用场景
适合分析短租市场、单个房源或一组竞品，例如比较不同城市或评估投资回报。它不用于寻找住宿，也不用于管理自己的房源、消息或预订。
运行要求
远程 Streamable HTTP 端点，无需安装。每个请求都必须在 X-API-KEY 请求头中提供 AirROI API 密钥，可从 AirROI 获取免费密钥。部分客户端需要 mcp-remote 之类的桥接工具，这需要 Node.js。需要网络访问。
安装前请注意
按调用付费，每次调用起价 0.01 美元，一次典型市场分析需要多次调用，费用会累积。X-API-KEY 是密钥，应避免写入共享配置。工具为只读，不能更改房源、价格、预订或消息，但导出会生成有效期为 7 天的下载链接文件。AirROI 是独立数据提供商，与 Airbnb 无关联。

安装

在 SourceWeft 中

  1. 打开 控制台中的 AirROI Airbnb MCP Server，将其添加到工作区。
  2. 连接 X-API-KEY 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/com.airroi%2Fmcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

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

README

[AirROI]

AirROI Airbnb MCP Server

Short-term rental market data for AI assistants · Remote · Streamable HTTP · com.airroi/mcp

AirROI's Airbnb MCP server gives Claude, Codex, Cursor, VS Code and any other Model Context Protocol client 29 tools for Airbnb and short-term rental market data: occupancy, ADR, RevPAR, revenue percentiles, comparables, revenue estimates, live Airbnb calendars and search rank, and price recommendations. It covers 20M+ listings in 190+ countries and answers from a maintained dataset, so your assistant never scrapes airbnb.com.

This repository is documentation only. The server is fully remote at https://mcp.airroi.com; there is nothing to install or run. AirROI is an independent data provider and is not affiliated with Airbnb. As of September 2026, Airbnb has no official MCP server or public API.

Endpointhttps://mcp.airroi.com
TransportStreamable HTTP (remote)
AuthX-API-KEY header, required on every request
Tools29 (11 market, 13 listing, 3 lookup and estimate, 2 pricing)
PriceFrom $0.01 per call, pay as you go
Registrycom.airroi/mcp in the official MCP Registry
Docshttps://www.airroi.com/mcp-server

Which Airbnb MCP server do you need?

"Airbnb MCP server" can mean three different things. Pick by the job:

You want to…Server typeExamplesAirROI?
Find a place to stayListing-search scraperApify, Bright DataNo
Run your own listings (messages, reservations, calendars)Property-management serverHospitable, GuestyNo
Analyze a market, a property or a comp setMarket-data MCPAirROIYes

A side-by-side comparison with pricing and limitations: https://www.airroi.com/mcp-server/compare

Get an API key

  1. Sign up for a free API key at https://www.airroi.com/api
  2. Activate it in the developer dashboard at https://www.airroi.com/api/developer/activate and copy the key.
  3. Use it as the X-API-KEY header value in the snippets below. Replace only YOUR_API_KEY.

Discovering tools (tools/list) is not billed, but every request needs the key.

Setup

Full, per-client guides: Claude · Codex and ChatGPT · every other client

Claude Code

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

Check it with claude mcp get airroi, then ask Claude a market question.

Claude Desktop

Claude Desktop connects to remote servers with custom headers through the mcp-remote bridge (needs Node.js). Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart the app:

json
{  "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" }    }  }}

Keep X-API-KEY:${AIRROI_API_KEY} free of spaces around the colon.

Codex (CLI, IDE extension and ChatGPT desktop app)

All three read ~/.codex/config.toml:

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

Then export AIRROI_API_KEY=YOUR_API_KEY in your shell profile. codex mcp list shows Auth: Unsupported for header auth; that is expected. ChatGPT on the web (developer mode) doesn't support API-key servers, so use Codex.

Cursor

~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

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

VS Code (Copilot agent mode)

.vscode/mcp.json. The top-level key is servers, not mcpServers:

json
{  "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 (formerly Windsurf)

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

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

Antigravity CLI (Gemini CLI's successor)

~/.gemini/config/mcp_config.json (global) or .agents/mcp_config.json (project):

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

n8n

  1. Add an AI Agent node, then attach an MCP Client Tool node to it.
  2. Set the endpoint to https://mcp.airroi.com and the transport to HTTP Streamable.
  3. Choose Header Auth and create a credential with name X-API-KEY and your key as the value.

OpenAI Agents SDK (Python)

python
import asyncio, osfrom agents import Agent, Runnerfrom 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())

Any stdio-only client

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

A real session

Prompt, run against the live server at mcp.airroi.com:

Compare Austin and Nashville for a 2-bedroom entire-home Airbnb: occupancy, ADR, RevPAR, annual revenue, and how many competing listings I'd face.

Tool calls: airroi_search_markets → airroi_search_markets → airroi_market_summary → airroi_market_summary → airroi_market_revenue → airroi_market_revenue (cost $0.42)

Over the trailing 12 months, 2-bedroom entire homes in Nashville earned more per listing: $40,075 in average annual revenue versus $24,965 in Austin. Occupancy is nearly identical (49% vs 48%), so the gap comes from rate: Nashville's ADR is $296 against Austin's $236, for RevPAR of $146 versus $114. Nashville also has less 2-bedroom supply, about 1,270 active listings a month versus about 2,029 in Austin. October 2025 was the strongest month for the median listing in both markets, at $5,009 in Nashville and $3,941 in Austin.

More sessions (live search rank, owner reports, forward pacing, Lisbon): https://www.airroi.com/mcp-server/use-cases

Tools (29)

No tool can change a listing, price, booking or message. 26 tools are flagged read-only; the other 3 create a download file or a scan cursor.

Market analytics (11)

ToolWhat it doesPrice per call
airroi_market_min_nightsTrack monthly average minimum-night settings and percentile breakdowns across a market. Use this to understand local stay restrictions alongside occupancy and pricing trends.$0.10
airroi_market_summaryGet a quick market overview with key stats: occupancy, ADR, RevPAR, average annual revenue per listing, booking lead time, length of stay, minimum nights, and active listing count. Returns a single-response trailing-12-month snapshot of any market.$0.10
airroi_market_metrics_allAccess all market metrics combined in one response. Returns monthly time-series with percentile breakdowns (avg, p25, p50, p75, p90) for occupancy, ADR, RevPAR, revenue, lead time, length of stay, minimum nights, and active listings -- the most comprehensive single tool.$0.50
airroi_market_occupancyTrack historical and seasonal occupancy rate trends with monthly time-series data. Returns average and percentile breakdowns to identify peak demand periods and booking patterns.$0.10
airroi_market_adrAnalyze Average Daily Rate trends with monthly time-series and percentile breakdowns. Track pricing compression, seasonal fluctuations, and rate growth across an entire market.$0.10
airroi_market_revparMonitor Revenue Per Available Rental combining occupancy and pricing into a single performance metric. Returns monthly time-series with percentile distributions for benchmarking.$0.10
airroi_market_revenueTrack monthly listing revenue with time-series and percentile breakdowns. Analyze revenue growth trends and seasonal patterns for investment opportunity sizing.$0.10
airroi_market_lead_timeUnderstand how far in advance guests book in any market, measured in days. Returns monthly time-series with percentiles to optimize pricing and marketing timing strategies.$0.10
airroi_market_losAnalyze average guest length-of-stay patterns measured in nights. Returns monthly time-series with percentile breakdowns for operational planning and minimum-stay optimization.$0.10
airroi_market_active_listingsMonitor market supply growth by tracking active listing counts over time. Identify new entrants, market saturation, and competitive landscape changes with monthly time-series data.$0.10
airroi_market_future_pacingAccess forward-looking booking pace for upcoming dates. Returns daily pacing data with booked count, available count, average rates, and fill rate for demand forecasting and revenue prediction.$0.20

Market lookup and revenue estimates (3)

ToolWhat it doesPrice per call
airroi_search_marketsSearch for short-term rental markets by name with prefix matching. Returns the exact market identifiers (country, region, locality, district) with active listing counts needed by all market tools.$0.01
airroi_lookup_marketResolve raw GPS coordinates to the exact market identifiers (country, region, locality, district) that every market tool requires. The reverse of search_markets — use it when you have a latitude/longitude instead of a place name.$0.01
airroi_estimate_revenueGenerate revenue projections for any location based on bedrooms, bathrooms, and guest capacity. Returns projected annual revenue, ADR, occupancy with percentile breakdowns (p25-p90), monthly distribution, and comparable listings.$0.20

Listing data (4)

ToolWhat it doesPrice per call
airroi_get_listingRetrieve full data for one Airbnb listing by ID: property details, description text, photo URLs, check-in and check-out times, guest-favorite status, pricing, ratings, and performance metrics including trailing-12-month and last-90-day occupancy, ADR, and revenue.$0.10
airroi_batch_listingsFetch detailed information for up to 25 properties in a single billed request. Returns counts and a downloadable JSON resource containing full property details and any per-ID errors. Downloading the resource does not repeat the API call.$1.00
airroi_find_comparablesDiscover up to 25 similar properties ranked by relevance based on location, bedrooms, bathrooms, and guest capacity. Specify location via coordinates or a physical address, and optionally a 1–10 mile radius and room type, for competitive benchmarking.$0.10
airroi_listing_metricsAccess up to 60 months of historical performance data per listing: monthly occupancy, ADR, RevPAR, revenue, and average minimum-night setting. Ideal for trend analysis, seasonality detection, and investment underwriting.$0.10

Listing search and export (4)

ToolWhat it doesPrice per call
airroi_search_by_marketSearch active listings within a city, region, or neighborhood using OpenStreetMap market definitions, or globally when no market is given. Filter by property attributes, host details, pricing, ratings, and performance metrics; returns up to 10 compact summaries per call.$0.50
airroi_search_by_radiusFind properties within a 1-100 mile radius of any GPS coordinates. Supports the same filtering and sorting as market search for location-based competitive analysis; returns up to 10 compact summaries per call.$0.50
airroi_search_by_polygonSearch listings within custom geographic boundaries defined by 3+ coordinate points. Draw any shape to define your search area for precise market segmentation and neighborhood analysis; returns up to 10 compact summaries per call.$0.50
airroi_exportExport every listing matching a market, radius, or custom polygon selector to a single downloadable file, delivered as a presigned download URL valid for 7 days. The full dataset is never streamed into the conversation — you get metadata, a short preview, and the download link to save locally. Choose JSONL (one full nested listing object per line) or CSV (flattened summary columns). Pagination is handled internally up to a 100,000-listing cap; very large exports return a partial file with counts if the time budget is reached. Ideal for bulk analysis, data pipelines, and offline scripting.$0.50 (1 call per 10 listings)

Live Airbnb data (5)

ToolWhat it doesPrice per call
airroi_live_calendarFetch a listing's calendar live from Airbnb: nightly rates (excluding the cleaning fee), availability, and minimum stays for the next 12 months, plus the host's cleaning fee and short-stay cleaning fee. Booked and host-blocked nights both show as unavailable.$0.20
airroi_live_ratesFetch just a listing's nightly rates live for the next 12 months, in native currency or US dollars. Use it for competitor price tracking when availability is not needed.$0.10
airroi_live_availabilityFetch a listing's availability and stay rules live for the next 12 months: open or unavailable nights, minimum and maximum stay, and whether guests can check in or check out on each date.$0.10
airroi_live_search_rankingSee the listings Airbnb search shows for a map rectangle, in rank order (up to 270). Use it to check where a listing appears in search against its competitors.$0.20
airroi_live_scanFind every Airbnb listing ID inside a custom polygon, live, up to 100 IDs per page. Continue with the short scan_id it returns; the server keeps the scan's progress, so each page stays small. Pair it with get_listing or batch_listings for full details.$0.50

Price recommendations (2)

ToolWhat it doesPrice per call
airroi_recommend_base_priceEstimate a year-round nightly starting price from property coordinates and known property facts. Optional amenities, reviews, and other details can refine the estimate. Nothing is saved or published.$0.10
airroi_recommend_calendar_pricesCalculate nightly prices from coordinates, currency, and a base price. Modeled seasonality, weekdays, events, and demand combine with optional pricing rules, seasonal overrides, price limits, and stay restrictions.$0.10

Full reference with parameters: https://www.airroi.com/mcp-server/tools

What a question costs

A typical market analysis takes six calls:

CallPrice
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

Price list: https://www.airroi.com/api/pricing

Data coverage

  • 20M+ listings in 190+ countries and 30,000+ markets
  • Monthly occupancy, ADR, RevPAR and revenue with p25/p50/p75/p90 percentiles, up to 60 months per request
  • Live Airbnb calendars, rates, availability and search rank, up to 12 months ahead
  • Native currencies, or USD on request

Links

License

MIT, see LICENSE.

来源：README.md，提交 ef37ed0

工具

0
该服务器需要 API 密钥等凭据，因此 SourceWeft 无法在没有凭据的情况下读取其工具，也未收录。

版本历史

2
  1. v1.0.1最新Sep 25, 2026
  2. v1.0.0Sep 16, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分