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.
- 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 guidePaid tools and approval
A paid tool called without confirmed: true runs nothing and returns a price quote. Show the quote to the user and repeat the call with confirmed: true only after they approve it.
Only successful calls are billed. A call that fails or returns no data costs nothing. Don't retry a paid call automatically after a timeout: it may still complete and bill.
Tools that create an analysis add 10 units for each AI function that completes.
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
get_report_link
Read only
Shareable report link
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