BNBCalc MCP reference

What the server exposes and how it behaves: authentication, every tool with its price, paid-tool approval, limits and errors. To connect an app, follow the setup guide.

Setup guideREST API docs
Address
https://atlas.bnbcalc.com/mcp
Transport
Streamable HTTP over POST, no sessions
Authentication
Sign in with BNBCalc (OAuth), or an API key in x-bnbcalc-api-key

Authentication

Apps that can open a sign-in page connect with OAuth: the user signs in to BNBCalc and clicks Allow, and the app sends the access token as a Bearer token. Free tools work for any signed-in account. Paid tools need the API subscription.

Apps and scripts that can't open a sign-in page send a BNBCalc API key in the x-bnbcalc-api-key header. Keys need the API subscription. When a request carries both a key and a token, the key wins.

Setup guide

Tools

Each tool calls the matching REST endpoint, so its results match the API. Prices are per successful call. A tool with a route under it takes the same fields as that endpoint.

Revenue and comps

estimate_revenue

Read only

Yearly revenue, nightly rate and occupancy

$0.10 (10 units)

find_comparables

Read only

Up to 50 nearby listings with revenue

$0.10 (10 units)

get_listing

Read only

One comparable listing in detail

$0.05 (5 units)

get_live_listing

Read only

Live details of an Airbnb listing

$0.05 (5 units)

get_listing_photos

Read only

Photos of a listing

Free

Analyses

create_buy_analysis

Saves to your account

Purchase analysis with cash flow and returns

POST /v1/external/analysis/create/buy

$0.20 (20 units)

create_owned_analysis

Saves to your account

Analysis of a property you already own

POST /v1/external/analysis/create/owned

$0.20 (20 units)

create_arbitrage_analysis

Saves to your account

Rental arbitrage analysis from monthly rent

POST /v1/external/analysis/create/arb

$0.20 (20 units)

create_cohost_analysis

Saves to your account

Co-hosting analysis with your commission

POST /v1/external/analysis/create/cohost

$0.20 (20 units)

enhance_analysis

Saves to your account

Add AI comps or AI expense estimates

POST /v1/external/analysis/enhance

$0.10 (10 units)

get_analysis

Read only

Read one saved analysis

Free

list_analyses

Read only

List your saved analyses

Free

get_ai_comps

Read only

AI comp picks and reasoning

Free

get_expense_estimates

Read only

AI expense estimates

Free

Property and rents

get_property_details

Read only

Beds, size, value and taxes for a US address

$0.05 (5 units)

get_rent_estimate

Read only

Long-term rent with comparable rentals

$0.05 (5 units)

get_section8_rents

Read only

Section 8 (HUD) and Census rents by ZIP

Free

Calculators

calculate_amortization

Read only

Loan payment and schedule

Free

calculate_dscr

Read only

Debt service coverage ratio

Free

calculate_tax_benefits

Read only

Depreciation and tax savings

Free

calculate_sell_or_refinance

Read only

Compare selling with refinancing

Free

Listing Optimizer

run_listing_optimization

Saves to your account

Rewrite and score an Airbnb listing

1 credit

get_listing_optimization

Read only

Status and score of a run

Free

list_listing_optimizations

Read only

Your past runs

Free

get_listing_optimization_report_url

Read only

Download link for a report

Free

Account and records

get_account

Read only

Plan, credits and key status

Free

get_usage

Read only

Requests and billed usage

Free

get_api_health

Read only

Check the API is up

Free

get_material_participation

Read only

Material participation hours and tests

Free

log_material_participation_hours

Saves to your account

Log hours for a property

Free

Limits

  • Data lookups share a daily limit with the REST API. It resets at 00:00 UTC, and failed lookups count too.
  • AI work is limited to 10 requests a minute and 2 at a time per account.
  • Analyses can't be edited or deleted through MCP.

Errors

The server answers with an HTTP status and a message that names the cause. The setup guide lists the common ones with their fixes.

Common errors and fixes Check the server status