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 分