AirROI Airbnb MCP Server

com.airroiPublished by airroi.comOfficial publisherv1.0.1Updated Oct 25, 2026

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

VerifiedStreamable HTTPWeb executableLocation & LifestyleFinanceData & Analytics

Overview

AI-generated overview

Remote AirROI server giving an assistant Airbnb short-term rental market data: occupancy, ADR, RevPAR, revenue, comparables and live rates.

What you can do
Search and resolve markets by name or GPS coordinates, and estimate revenue for a location by bedrooms, bathrooms and capacity. Pull market analytics: occupancy, ADR, RevPAR, revenue, lead time, length of stay, minimum nights, active listings and forward pacing, with percentile breakdowns. Look up single listings, batch up to 25, find comparables and read up to 60 months of listing metrics. Search listings by market, radius or polygon, and export matching listings to a downloadable file. Fetch live Airbnb calendars, rates, availability, search ranking and polygon scans. Recommend a base nightly price and calendar prices from property facts.
When to use it
Use it to analyze a short-term rental market, a property or a set of competitors, for example comparing cities or sizing investment returns. It is not for finding a place to stay or for managing your own listings, messages or reservations.
Requirements
A remote Streamable HTTP endpoint; nothing to install. An AirROI API key is required on every request in the X-API-KEY header; a free key is available from AirROI. Some clients need a bridge such as mcp-remote, which requires Node.js. Network access is required.
Before you install
Usage is pay as you go, from $0.01 per call, and a typical market analysis costs several calls, so spending can add up. The X-API-KEY is a secret and should be kept out of shared configuration. Tools are read-only and cannot change listings, prices, bookings or messages, but exports create downloadable files with a 7-day link. AirROI is an independent provider and is not affiliated with Airbnb.

Installation

In SourceWeft

  1. Open AirROI Airbnb MCP Server in the dashboard and add it to a workspace.
  2. Connect X-API-KEY credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.airroi%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "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.

Source: README.md at commit ef37ed0

Tools

0
This server asks for a credential such as an API key, so SourceWeft could not read its tools without one and has not indexed them.

Version history

2
  1. v1.0.1LatestSep 25, 2026
  2. v1.0.0Sep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts