MCP tool reference

29 Airbnb Analytics Tools for Your AI Assistant

Every tool on the AirROI MCP server, with what it returns and what it costs per call: market analytics, listings, live Airbnb data, comps, revenue estimates and price recommendations.

Get your API keySee every price

MCP protocol 2025-11-25Registry com.airroi/mcp

Price per call

Standard rates

  • $0.012 tools
  • $0.1016 tools
  • $0.204 tools
  • $0.506 tools
  • $1.001 tool

tools/list is free. Pay-as-you-go credits, $10 minimum deposit, same price as the REST API. Every tool's price

MCP tools
29
Tool categories
6
Read-only tools
26
Starting price per call
$0.01

Tools at a glance

The AirROI MCP server has 29 tools in four groups: 13 listing tools (5 of them live), 11 market tools, 3 lookup and revenue tools and 2 pricing tools.

Each tool name starts with airroi_, calls the matching AirROI API endpoint at the same per-call price, and works in any MCP client that sends your API key.

New here? The Airbnb MCP server overview explains what the server is and shows a full session, and the Airbnb MCP setup guide connects Cursor, VS Code, n8n or your own agent in a couple of minutes. The same operations are documented for direct HTTP calls in the AirROI API endpoint reference.

13 Listing Tools

From $0.10 per call

One listing or a batch of 25, comparable listings, search by market, radius or polygon, and bulk export to CSV or JSONL. 5 of them read Airbnb live.

11 Market Tools

From $0.10 per call

Occupancy, ADR, RevPAR, revenue, lead time, stay length, minimum nights, supply and forward pacing for any market, filtered to your segment.

3 Lookup & Revenue Tools

From $0.01 per call

Turn a place name or coordinates into the market every market tool needs, and project an address's annual revenue.

2 Pricing Tools

$0.10 per call

A recommended base price with three options, then nightly prices for up to two years. Neither tool publishes anything.

11 tools · From $0.10 per call

Market analytics tools

The 11 market tools answer "how does this market perform?" for any of 30,000+ markets in 190+ countries. airroi_market_summary returns trailing-12-month occupancy, ADR, RevPAR and revenue in one call.

The monthly tools return average, p25, p50, p75 and p90 values for up to 60 months, filtered to your segment, in local currency or US dollars.

Occupancy, ADR, RevPAR, revenue, lead time, length of stay, minimum nights and active listings each have a monthly tool, and airroi_market_metrics_all returns them all at once. airroi_market_future_pacing shows how full upcoming nights already are, which revenue managers call pacing. Filters and currency make “Lisbon 1BR in euros” one question: in a real session, it returned 57% occupancy, a €130.60 ADR and about €20,600 a year per listing.

One snapshot of a market

airroi_market_summary

$0.10

Trailing-12-month averages for every headline metric in one response.

One metric, month by month

airroi_market_occupancyairroi_market_adrairroi_market_revpar

$0.10 each

Revenue, lead time, stay length, minimum nights and supply work the same way.

Every metric, month by month

airroi_market_metrics_all

$0.50

Cheaper than 6 single-metric calls ($0.60).

Demand for upcoming dates

airroi_market_future_pacing

$0.20

Booked and available counts, average rate and fill rate for each future night.

Market analytics tools: Standard price per call. Shaded parameters are required.
ToolWhat it returnsKey parametersPer call
airroi_market_summaryMarket SummaryOccupancy, ADR, RevPAR, revenue, lead time, LOS, min nights, listing countAsk: “Give me a quick overview of the Scottsdale vacation rental market”
  • market (required)
  • filter
  • num_months
  • currency
$0.10
airroi_market_metrics_allAll Market MetricsAll metrics as monthly time-series with p25/p50/p75/p90Ask: “Show me all KPIs for Miami Beach over the last 24 months”
  • market (required)
  • filter
  • num_months
  • currency
$0.50
airroi_market_occupancyMarket OccupancyMonthly occupancy rates with percentile breakdownsAsk: “What are the occupancy trends in the Smoky Mountains by month?”
  • market (required)
  • filter
  • num_months
  • currency
$0.10
airroi_market_adrMarket Average Daily RateMonthly ADR with percentile breakdownsAsk: “Compare ADR trends in Austin vs Nashville over 24 months”
  • market (required)
  • filter
  • num_months
  • currency
$0.10
airroi_market_revparMarket RevPARMonthly RevPAR combining occupancy and pricing performanceAsk: “What's the average RevPAR in Los Angeles for the last 2 years?”
  • market (required)
  • filter
  • num_months
  • currency
$0.10
airroi_market_revenueMarket RevenueMonthly revenue per listing with percentile distributionsAsk: “How has revenue grown in Destin over the past 3 years?”
  • market (required)
  • filter
  • num_months
  • currency
$0.10
airroi_market_min_nightsMarket Minimum NightsMonthly minimum-night settings with average, p25, p50, p75 and p90Ask: “How have minimum-night requirements changed in Miami Beach over the last year?”
  • market (required)
  • filter
  • num_months
  • currency
$0.10
airroi_market_lead_timeMarket Booking Lead TimeMonthly booking lead time in days with percentilesAsk: “How far in advance do guests book in Maui vs Big Island?”
  • market (required)
  • filter
  • num_months
  • currency
$0.10
airroi_market_losMarket Length of StayMonthly average stay duration in nights with percentilesAsk: “What's the typical length of stay in Gulf Shores by season?”
  • market (required)
  • filter
  • num_months
  • currency
$0.10
airroi_market_active_listingsMarket Active ListingsMonthly active listing counts and supply growth trendsAsk: “Is the Joshua Tree market getting saturated? Show supply growth”
  • market (required)
  • filter
  • num_months
  • currency
$0.10
airroi_market_future_pacingMarket Future PacingDaily pacing: booked/available counts, rates, fill rateAsk: “What does the booking pace look like for Gatlinburg this summer?”
  • market (required)
  • filter
  • num_months
  • currency
$0.20

8 tools · From $0.10 per call

Listing, comps and search tools

The 8 listing tools cover single properties, comps and search. The 4 core tools fetch one listing, up to 25 listings in a batch, up to 25 comparable listings within 1–10 miles, or up to 60 months of a listing's history.

The 4 search tools find listings by market, radius or polygon, and airroi_export saves up to 100,000 of them to a file.

comparable listings per call, within 1–10 miles
25
maximum radius for listing search
100 mi
listing IDs per batch call
25
of monthly history per listing
60 mo
listings per export, CSV or JSONL
100,000
lifetime of an export's download link
7 days

Underwriting starts with a comp set: airroi_find_comparables returns up to 25 similar listings with their trailing-12-month revenue, occupancy and ADR, and airroi_estimate_revenue adds an address-level projection. The Claude guide, Connect Claude to Airbnb data, shows a real estimate with its comps.

airroi_export never streams the dataset into the chat. It returns a count, a short preview and a download link that Codex, Claude Code, Cursor or any coding agent can load into a notebook or script. The Codex guide, Use Airbnb data in Codex and ChatGPT, shows how.

Listing, comps and search tools: Standard price per call. Shaded parameters are required.
ToolWhat it returnsKey parametersPer call
Listing data (4)
airroi_get_listingGet ListingProperty details, photos, ratings, pricing, TTM and L90D performance metricsAsk: “Tell me everything about Airbnb listing 1238217617”
  • id (required)
  • currency
$0.10
airroi_batch_listingsBatch Get ListingsRequested/result/error counts and a downloadable JSON resource containing the complete batch responseAsk: “Pull performance data for all 12 listings in my portfolio”
  • listing_ids (required)
  • currency
$1.00
airroi_find_comparablesFind Comparable ListingsUp to 25 comps ranked by relevance with TTM revenue, occupancy, ADRAsk: “Find comparable 2BR listings near 742 Oceanfront Walk, Venice”
  • latitude
  • longitude
  • address
  • bedrooms (required)
  • baths (required)
  • guests (required)
  • radius
  • room_type
  • currency
$0.10
airroi_listing_metricsListing Historical MetricsMonthly occupancy, ADR, RevPAR, revenue, min-nights time-seriesAsk: “Show me 2 years of monthly revenue history for listing 456789”
  • id (required)
  • currency
  • num_months
$0.10
Listing search and export (4)
airroi_search_by_marketSearch Listings by MarketCompact listing summaries (name, bedrooms, revenue, occupancy, ADR), 10 per pageAsk: “Find all 3BR entire homes in Nashville earning over $80K/year”
  • market
  • filter
  • sort
  • pagination
  • currency
$0.50
airroi_search_by_radiusSearch Listings by RadiusCompact listing summaries sorted by distance or performanceAsk: “Find listings within 5 miles of downtown Austin with 4.5+ stars”
  • latitude (required)
  • longitude (required)
  • radius_miles
  • filter
  • sort
  • pagination
  • currency
$0.50
airroi_search_by_polygonSearch Listings by PolygonCompact listing summaries inside the custom boundaryAsk: “Search only the beachfront strip between these 4 coordinates”
  • polygon (required)
  • filter
  • sort
  • pagination
  • currency
$0.50
airroi_exportExport Listings DatasetTotal count, a short preview, and a 7-day presigned download URL (JSONL or CSV)Ask: “Export every listing in Nashville to a CSV I can download and open in a spreadsheet”
  • by (required)
  • market
  • latitude
  • longitude
  • radius_miles
  • polygon
  • filter
  • sort
  • currency
  • format
$0.50Billed as one search call per 10 listings exported

5 tools · From $0.10 per call

Live Airbnb data tools

The 5 live tools read Airbnb at the moment you ask. airroi_live_calendar returns a listing's nightly rates, availability, minimum stays and cleaning fees for up to 12 months ahead, and two lighter tools return only rates or only availability. airroi_live_search_ranking lists up to 270 listings in Airbnb search order for a map area or place name, and airroi_live_scan finds every listing ID inside a place, map area or polygon.

Live Airbnb data tools: Standard price per call. Shaded parameters are required.
ToolWhat it returnsKey parametersPer call
airroi_live_calendarLive Listing CalendarDaily rates, availability, minimum stay, cleaning fee and short-stay cleaning feeAsk: “What are the nightly rates for this cabin over the next 90 days?”
  • id (required)
  • currency
$0.20
airroi_live_ratesLive Listing RatesDaily rates with the ISO currency codeAsk: “Track this competitor's nightly prices for the next 6 months”
  • id (required)
  • currency
$0.10
airroi_live_availabilityLive Listing AvailabilityDaily availability, min/max nights, check-in and check-out rulesAsk: “Which weekends in October are still open at this listing?”
  • id (required)
$0.10
airroi_live_search_rankingLive Search RankingUp to 270 listing IDs with their search rankAsk: “Where does my listing rank in Airbnb search for downtown Nashville?”
  • bounds
  • place_name
  • start_date
  • end_date
  • adults
  • children
  • infants
  • pets
$0.20
airroi_live_scanLive Listing ScanListing IDs for the page and a scan_id for the next pageAsk: “List every Airbnb inside this lakefront boundary”
  • place_name
  • bounds
  • polygon
  • scan_id
  • page_size
$0.50

A competitor's calendar and fees

airroi_live_calendar ($0.20) returns each future night's rate, availability and minimum stay for any listing ID, plus the cleaning fee and short-stay cleaning fee. Rates exclude the cleaning fee, and booked and host-blocked nights both show as unavailable. airroi_live_rates and airroi_live_availability ($0.10 each) return only the rates, or only the open dates and stay rules.

Where listings rank in search

airroi_live_search_ranking returns listings in the order Airbnb search shows them for a map rectangle or a place name. In the Gulch test, search returned 226 listings and only two of 25 comps appeared, at #86 and #177. The host session is one of the Airbnb MCP use cases.

Live, without a local scraper

Scraper-based servers load airbnb.com from your machine for each question. These tools run on AirROI's servers and return JSON. Compare Airbnb MCP servers to see the difference.

Host

Check a competitor's live calendar

Prompt

Pull the live Airbnb calendar for listing 32568787 ("Perfect Pad in the Gulch") for the next 30 days: nightly rates, open nights, minimum stay and cleaning fee.

1 tool call

  1. airroi_live_calendar$0.20

    id: 32568787 · currency: usd

    Response excerpt (first 30 nightly rows shown)
    {
  "currency": "USD",
  "cleaning_fee": 165,
  "short_stay_cleaning_fee": 165,
  "results": [
    {
      "date": "2026-09-25",
      "available": false,
      "rate": 350,
      "min_nights": 2
    },
    {
      "date": "2026-09-26",
      "available": false,
      "rate": 347,
      "min_nights": 2
    },
    {
      "date": "2026-09-27",
      "available": false,
      "rate": 250,
      "min_nights": 1
    },
    {
      "date": "2026-09-28",
      "available": false,
      "rate": 297,
      "min_nights": 1
    },
    {
      "date": "2026-09-29",
      "available": false,
      "rate": 297,
      "min_nights": 1
    },
    {
      "date": "2026-09-30",
      "available": false,
      "rate": 297,
      "min_nights": 1
    },
    {
      "date": "2026-10-01",
      "available": false,
      "rate": 297,
      "min_nights": 1
    },
    {
      "date": "2026-10-02",
      "available": false,
      "rate": 297,
      "min_nights": 2
    },
    {
      "date": "2026-10-03",
      "available": false,
      "rate": 297,
      "min_nights": 2
    },
    {
      "date": "2026-10-04",
      "available": false,
      "rate": 297,
      "min_nights": 1
    },
    {
      "date": "2026-10-05",
      "available": false,
      "rate": 297,
      "min_nights": 1
    },
    {
      "date": "2026-10-06",
      "available": false,
      "rate": 297,
      "min_nights": 1
    },
    {
      "date": "2026-10-07",
      "available": false,
      "rate": 297,
      "min_nights": 1
    },
    {
      "date": "2026-10-08",
      "available": false,
      "rate": 297,
      "min_nights": 1
    },
    {
      "date": "2026-10-09",
      "available": false,
      "rate": 297,
      "min_nights": 2
    },
    {
      "date": "2026-10-10",
      "available": false,
      "rate": 297,
      "min_nights": 2
    },
    {
      "date": "2026-10-11",
      "available": false,
      "rate": 297,
      "min_nights": 1
    },
    {
      "date": "2026-10-12",
      "available": true,
      "rate": 297,
      "min_nights": 1
    },
    {
      "date": "2026-10-13",
      "available": true,
      "rate": 164,
      "min_nights": 1
    },
    {
      "date": "2026-10-14",
      "available": true,
      "rate": 275,
      "min_nights": 1
    },
    {
      "date": "2026-10-15",
      "available": true,
      "rate": 495,
      "min_nights": 1
    },
    {
      "date": "2026-10-16",
      "available": false,
      "rate": 464.4,
      "min_nights": 2
    },
    {
      "date": "2026-10-17",
      "available": false,
      "rate": 433.8,
      "min_nights": 2
    },
    {
      "date": "2026-10-18",
      "available": false,
      "rate": 403.3,
      "min_nights": 1
    },
    {
      "date": "2026-10-19",
      "available": false,
      "rate": 372.7,
      "min_nights": 1
    },
    {
      "date": "2026-10-20",
      "available": false,
      "rate": 342.1,
      "min_nights": 1
    },
    {
      "date": "2026-10-21",
      "available": false,
      "rate": 311.5,
      "min_nights": 1
    },
    {
      "date": "2026-10-22",
      "available": false,
      "rate": 280.9,
      "min_nights": 1
    },
    {
      "date": "2026-10-23",
      "available": false,
      "rate": 250.3,
      "min_nights": 2
    },
    {
      "date": "2026-10-24",
      "available": false,
      "rate": 219.8,
      "min_nights": 2
    }
  ]
}

Answer written from these results

Between September 25 and October 24, 2026, only 4 of 30 nights are open (October 12–15). The other 26 show as unavailable, which covers both booked and host-blocked nights. Nightly rates run from $164 to $495 and average $314 over the 30 days; the four open nights are priced at $297, $164, $275 and $495. Minimum stay is 1 or 2 nights, and the host adds a $165 cleaning fee per stay on top of the nightly rate.

Run against mcp.airroi.com · 1 call · cost $0.20

3 tools · From $0.01 per call

Market lookup and revenue estimates

The 3 lookup and revenue tools sit in front of the others. airroi_search_markets turns a place name into the market identifiers every market tool needs, and airroi_lookup_market does the same from coordinates, at $0.01 each. airroi_estimate_revenue projects annual revenue, ADR and occupancy for an address or coordinates, with p25 to p90 ranges and comparable listings.

  1. 1. Ask about a place

    "Lisbon"

  2. 2. Resolve it ($0.01)

    airroi_search_markets

  3. 3. Get the market object

    Portugal · Lisbon · Lisbon

  4. 4. Call any market tool

    airroi_market_summary

Most sessions start with a $0.01 lookup. Search returns matching markets with their active listing counts, so the assistant picks the right Portland before it spends anything on metrics. airroi_estimate_revenue ($0.20) takes bedrooms, bathrooms and guests plus a location, and returns a monthly breakdown with the annual figure.

Market lookup and revenue tools: Standard price per call. Shaded parameters are required.
ToolWhat it returnsKey parametersPer call
airroi_search_marketsSearch MarketsMarket hierarchy (country/state/city/neighborhood) + countsAsk: “Find all markets matching 'Joshua' with listing counts”
  • query (required)
$0.01
airroi_lookup_marketLook Up Market by CoordinatesMarket hierarchy (country/region/locality/district) for the pointAsk: “What market do the coordinates 36.16, -86.78 belong to?”
  • lat (required)
  • lng (required)
$0.01
airroi_estimate_revenueEstimate Revenue PotentialProjected revenue, ADR, occupancy (p25-p90) + monthly breakdownAsk: “Estimate revenue for a 3BR house at 123 Ocean Drive, Miami Beach”
  • lat
  • lng
  • address
  • bedrooms (required)
  • baths (required)
  • guests (required)
  • radius
  • room_type
  • currency
$0.20

2 pricing tools

Price recommendations: from base price to nightly rates

Two tools turn a property into prices. airroi_recommend_base_price returns a year-round base price with conservative, balanced and aggressive options and an itemized explanation.

airroi_recommend_calendar_prices turns that base price into nightly recommendations for up to a one- to two-year calendar. They cost $0.10 a call each, and neither publishes rates or changes settings.

Both run through your existing AirROI MCP connection and API key. They calculate recommended prices; airroi_live_calendar shows the rates a listing actually charges, and airroi_estimate_revenue projects what a property could earn.

Call 1$0.10 per call

Recommend Base Price

airroi_recommend_base_price

Estimate 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.

Try asking

Recommend a base price in USD for a 2-bedroom, 2-bath property sleeping 4 at latitude 25.7907, longitude -80.13. Explain the recommendation.

Returns

Recommended base price, conservative/balanced/aggressive options, typical local price range, returned currency, and itemized explanation

Recommend Base Price API contract
Call 2$0.10 per call

Recommend Calendar Prices

airroi_recommend_calendar_prices

Calculate 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.

Try asking

Use the returned base price and currency to recommend nightly rates for the same property with balanced last-minute pricing. Summarize the next 30 days and all warnings; do not publish anything.

Returns

The complete response inline: nightly recommendations, explanations, stay restrictions, coverage, and warnings. Omitted or null start_date and end_date return one to two years of dates from today in the property timezone; inclusive boundaries select a window

Recommend Calendar Prices API contract

A two-call pricing workflow

  1. Send exact coordinates, bedrooms, bathrooms and guest capacity to airroi_recommend_base_price. Leave out optional property facts you don't know.

  2. Pass recommended_base_price and the returned uppercase currency to airroi_recommend_calendar_prices, or supply your own base price and currency. Currency takes ISO codes such as USD or JPY; the analytics option native doesn't apply here.

  3. Add pricing rules and availability evidence when you need them. The calendar is booking evidence, not an output date selector. Missing dates are unknown, so include surrounding reservations and blocked dates for calendar-dependent rules.

  4. Review explanations and warnings, including warnings on successful responses, before you publish anything through your own integration.

Dates, warnings and billing

Output
Calendar Prices returns the complete response inline: nightly prices, explanations, stay restrictions, coverage and all warnings.
Dates
Output starts today in the property's timezone unless start_date is set. Omitted or null start_date and end_date return the full one- to two-year calendar; inclusive boundaries select a window, and the same day in both returns one row. Past or malformed dates fail, and an end_date beyond coverage is clamped to the available calendar.
Warnings
Selecting a window keeps the full-calendar calculation, so warning counts can include later dates. Review warnings even when the request succeeds.
State
The calculation is stateless: resend settings and calendar evidence with each request. No property settings are changed or rates published. Your booking integration must enforce the returned stay restrictions, and length-of-stay discounts are accepted but not applied to recommendations.
Billing
Both tools draw the same paid credits as their REST endpoints ($0.10 a call each). Calendar Prices is billed per successful request, not per night.

The workflow in a real session

The same two calls, run against the live server. The base price explains every adjustment, and the calendar returns one row per night for the requested window, with any warnings. Nothing was published. To sanity-check a recommendation, run airroi_live_calendar on two or three comps. More sessions are in the Airbnb MCP use cases.

Host

Get a base price and nightly rates

Prompt

Recommend a base price for a 2BR/2BA Gulch condo that sleeps 6, then nightly prices for October 2026. Don't publish anything.

2 tool calls

  1. airroi_recommend_base_price$0.10

    location: latitude 36.151, longitude -86.7826 · property: bedrooms 2, baths 2, guests 6, room_type entire_home · currency: USD

    Response excerpt
    {
  "location": {
    "latitude": 36.15,
    "longitude": -86.78
  },
  "currency": "USD",
  "explanation": [
    {
      "code": "market_baseline",
      "label": "Market baseline",
      "amount": 262
    },
    {
      "code": "bedrooms",
      "label": "2 bedrooms",
      "amount": 0
    },
    {
      "code": "bathrooms",
      "label": "2 bathrooms",
      "amount": 38
    },
    {
      "code": "guest_capacity",
      "label": "Sleeps 6",
      "amount": 0
    },
    {
      "code": "property_details",
      "label": "Property features",
      "amount": 1,
      "details": [
        "Based on otherwise similar properties.",
        "Room type: entire_home"
      ]
    },
    {
      "code": "current_market_level",
      "label": "Current market adjustment",
      "amount": 0
    }
  ],
  "recommended_base_price": 301,
  "price_options": {
    "conservative": 277,
    "balanced": 301,
    "aggressive": 326
  },
  "typical_market_range": {
    "low": 231,
    "high": 393
  }
}
  2. airroi_recommend_calendar_prices$0.10

    location: latitude 36.151, longitude -86.7826 · currency: USD · base_price: 301 · start_date: 2026-10-01 · end_date: 2026-10-31

    Response excerpt (first 10 of 31 nights shown; explanations kept for October 5 and October 9)
    {
  "currency": "USD",
  "coverage": {
    "calculation_date": "2026-09-25",
    "start_date": "2026-10-01",
    "end_date": "2026-10-31",
    "recommendation_count": 31,
    "timezone": "America/Chicago"
  },
  "warnings": [],
  "recommendations": [
    {
      "date": "2026-10-01",
      "price": 361.95
    },
    {
      "date": "2026-10-02",
      "price": 390.05
    },
    {
      "date": "2026-10-03",
      "price": 360.2
    },
    {
      "date": "2026-10-04",
      "price": 306.28
    },
    {
      "date": "2026-10-05",
      "price": 287.82,
      "explanation": [
        {
          "code": "base_price",
          "label": "Base price",
          "amount": 301
        },
        {
          "code": "seasonality",
          "label": "Seasonality",
          "adjustment_percent": 9.33,
          "amount": 28.07
        },
        {
          "code": "day_of_week",
          "label": "Day of week",
          "adjustment_percent": -12.54,
          "amount": -41.25
        },
        {
          "code": "known_holiday_event",
          "label": "Holiday/event",
          "adjustment_percent": 0,
          "amount": 0
        },
        {
          "code": "market_demand",
          "label": "Market demand",
          "adjustment_percent": 0,
          "amount": 0
        }
      ]
    },
    {
      "date": "2026-10-06",
      "price": 295.62
    },
    {
      "date": "2026-10-07",
      "price": 315.44
    },
    {
      "date": "2026-10-08",
      "price": 612.17
    },
    {
      "date": "2026-10-09",
      "price": 670.07,
      "explanation": [
        {
          "code": "base_price",
          "label": "Base price",
          "amount": 301
        },
        {
          "code": "seasonality",
          "label": "Seasonality",
          "adjustment_percent": 9.42,
          "amount": 28.37
        },
        {
          "code": "day_of_week",
          "label": "Day of week",
          "adjustment_percent": 18.53,
          "amount": 61.03
        },
        {
          "code": "known_holiday_event",
          "label": "Holiday/event",
          "adjustment_percent": 0,
          "amount": 0
        },
        {
          "code": "market_demand",
          "label": "Market demand",
          "adjustment_percent": 71.6,
          "amount": 279.67
        }
      ]
    },
    {
      "date": "2026-10-10",
      "price": 619.08
    }
  ]
}

Answer written from these results

The recommended base price is $301 a night (conservative $277, aggressive $326), inside a typical local range of $231 to $393. It starts from a $262 market baseline and adds $38 for the two bathrooms and $1 for property features. October's nightly recommendations run from $288 (Monday, October 5) to $670 (Friday, October 9) and average $386. Friday nights average $492 against $289 on Mondays, and October 9–10 carry a +71.6% market-demand adjustment. No warnings came back, and nothing was published or changed.

Run against mcp.airroi.com · 2 calls · cost $0.20

What each tool costs

AirROI MCP tools start at $0.01 per call at Standard rates, the same as the matching REST endpoint, and 16 of the 29 cost $0.10. There's no subscription: you buy pay-as-you-go credits with a $10 minimum deposit, and your API key draws them down.

Listing the tools with tools/list is free.

Standard price per call. airroi_export: billed as one search call per 10 listings exported.
Per callToolsCount
$0.012
$0.1016
$0.204
$0.506
$1.001

What a whole question costs

Assistants chain several tools per question. Underwriting one property takes a revenue estimate, a comp set, a competitor's live calendar and a base price:

Underwrite one property

  • airroi_estimate_revenue$0.20
  • airroi_find_comparables$0.10
  • airroi_live_calendar$0.20
  • airroi_recommend_base_price$0.10
Total$0.60

Standard per-call prices; listing the tools (tools/list) is not billed. Pay-as-you-go credits with a $10 minimum deposit.

Preferred Partner accounts pay about half on most tools, and every tool bills exactly like its REST endpoint, so one balance covers both. Current rates for every plan are on AirROI API pricing.

Parameters every tool shares

The 11 market tools take the same four parameters: market, the country, region, locality and optional district returned by airroi_search_markets; filter, conditions such as bedrooms equal to 1; currency, "native" or "usd"; and num_months, up to 60.

Search tools add sort and pagination, and listing tools take a listing id.

market
An object with country, region, locality and, for neighborhoods, district. Copy it from airroi_search_markets or airroi_lookup_market instead of typing it: names must match exactly (Nashville is Nashville-Davidson).
filter
Field, operator, value. Operators are eq, gt, gte, lt, lte, range, any, all and none. Filter on bedrooms, room type, amenities or trailing-12-month revenue, so the benchmark matches your segment.
currency
native (the market's own currency, such as EUR in Lisbon) or usd. The two pricing tools take ISO codes such as USD instead.
num_months
Months of history, up to 60. Use 24 or 36 to compare a month with the same month a year earlier.
sort, pagination
Search tools return 10 compact summaries per call. Sort by any returned field and page through the rest, or hand the same selector to airroi_export.
id
Listing and live tools take an Airbnb listing ID, such as 32568787 from the calendar example above.
airroi_market_summary argumentsjson
{
  "market": {
    "country": "Portugal",
    "region": "Lisbon",
    "locality": "Lisbon"
  },
  "filter": {
    "room_type": {
      "eq": "entire_home"
    },
    "bedrooms": {
      "eq": 1
    }
  },
  "num_months": 12,
  "currency": "native"
}

Copied from a real Lisbon session. Your assistant writes these arguments for you; you only ask the question.

What the tools can and can't do

No AirROI MCP tool can change a listing, price, booking or message, and the server never signs in to your Airbnb account. 26 of the 29 tools carry the MCP readOnlyHint annotation.

The other 3, airroi_batch_listings, airroi_live_scan and airroi_export, aren't flagged only because they create something on AirROI's side: a download file or a scan cursor.

  • 26 flagged readOnlyHint
  • 3 create a download file or scan cursor
airroi_batch_listings

Creates

A downloadable JSON resource holding the complete response for up to 25 listings. Downloading it doesn't repeat the call.

airroi_live_scan

Creates

A short scan_id cursor. The server keeps the scan's progress for 24 hours so each page of up to 100 IDs stays small.

airroi_export

Creates

A JSONL or CSV file behind a presigned download link that stays valid for 7 days.

Read the data, change nothing

There is no tool for publishing rates, editing a listing, accepting a booking or messaging a guest. The pricing tools return numbers for you to review, and AirROI never touches your Airbnb or PMS account. To act on your own listings, add your PMS's MCP server next to AirROI.

readOnlyHint and openWorldHint are tool annotations defined by the MCP specification. They are hints a client can use when it decides how to present or confirm a call. Every AirROI tool also sets openWorldHint, which tells the client the tool reaches data outside the server.

Frequently asked questions

29, in four groups:

  • 13 listing tools, 5 of them live
  • 11 market tools
  • 3 lookup and revenue tools
  • 2 price-recommendation tools

Every tool is prefixed airroi_ and maps to a REST endpoint at the same price.

airroi_market_summary ($0.10) returns the trailing-12-month headline metrics in one call. For month-by-month trends, use airroi_market_occupancy, airroi_market_adr or airroi_market_revpar ($0.10 each), or airroi_market_metrics_all ($0.50) for everything at once. The monthly tools return average, p25, p50, p75 and p90 values for each month.

From AirROI's market tools, for any of 30,000+ markets in 190+ countries. Filter to your segment (for example 2-bedroom entire homes) and compare your listing's numbers with the market's p50 and p75. airroi_find_comparables narrows the benchmark to up to 25 of the closest similar listings, and airroi_listing_metrics returns your own listing's monthly numbers to compare.

Up to 60 months (5 years) of monthly data per request. Every market metric tool and airroi_listing_metrics take a num_months parameter of up to 60. Ask for 24 or 36 months to see year-over-year seasonality, for example "How did July compare to last July?"

airroi_live_search_ranking takes a map rectangle or a place name like "Wilmington, NC" and returns up to 270 listing IDs in the order Airbnb search shows them right now ($0.20). Add check-in and check-out dates and guest counts to rank a dated search. In a real session, a Nashville Gulch rectangle returned 226 listings, and two of a condo's 25 comps ranked #86 and #177. Run it on a schedule to track visibility.

Yes. airroi_export takes a market, a radius or a polygon and writes up to 100,000 listings to a CSV or JSONL file with a download link valid for 7 days. It's billed as 1 search call per 10 listings ($0.50 per 10 listings at Standard rates). For up to 25 specific IDs, airroi_batch_listings ($1.00) returns full details as one downloadable resource.

airroi_recommend_base_price returns conservative, balanced and aggressive base prices with an explanation of the adjustments. airroi_recommend_calendar_prices returns one to two years of nightly prices, following your pricing rules, stay rules, limits and overrides. They cost $0.10 each, and neither publishes anything. For a Gulch 2BR the base came back at $301 ($277–$326).

Standard prices per call:

  • $0.01: Search Markets, Look Up Market by Coordinates
  • $0.10: Get Listing, Find Comparable Listings, Listing Historical Metrics, Live Listing Rates, Live Listing Availability, Market Minimum Nights, Market Summary, Market Occupancy, Market Average Daily Rate, Market RevPAR, Market Revenue, Market Booking Lead Time, Market Length of Stay, Market Active Listings, Recommend Base Price, Recommend Calendar Prices
  • $0.20: Live Listing Calendar, Live Search Ranking, Market Future Pacing, Estimate Revenue Potential
  • $0.50: Live Listing Scan, Search Listings by Market, Search Listings by Radius, Search Listings by Polygon, Export Listings Dataset, All Market Metrics
  • $1.00: Batch Get Listings

airroi_export bills one search call per 10 listings. Preferred Partner accounts pay about half on most tools. tools/list is free, and credits start with a $10 minimum deposit.

Put all 29 tools in your AI assistant

One API key works in Claude, Codex, Cursor, VS Code and n8n. Pay per call from $0.01, after a $10 minimum deposit.

Get your API keySee the tools in real sessions