> For AI agents: BNBCalc's MCP server is at https://atlas.bnbcalc.com/mcp (setup: https://www.bnbcalc.com/developers/mcp). Index of every BNBCalc page: https://www.bnbcalc.com/llms.txt

# BNBCalc MCP server

Analyze any Airbnb deal from Claude, Cursor or any MCP client. Revenue, comps and cash flow on BNBCalc data.

No monthly fee. Paid tools show their price and run only after you approve it. Calls that fail or return no data are free.

- MCP server: `https://atlas.bnbcalc.com/mcp`
- Authentication: sign in with a BNBCalc account (OAuth), or send your BNBCalc API key in the x-bnbcalc-api-key header
- API subscription and keys: https://www.bnbcalc.com/dashboard/settings/api-access
- See tool prices: https://www.bnbcalc.com/developers/mcp
- Updated: 2026-11-12

---

## Connect a client

### Claude

```text
https://atlas.bnbcalc.com/mcp
```

In Claude, open Settings, then Customize, and add a custom connector with this URL. Sign in to BNBCalc when asked.

### ChatGPT

```text
https://atlas.bnbcalc.com/mcp
```

In ChatGPT, open Settings, then Plugins, click Browse directory and add a custom MCP server with this URL and OAuth. Sign in to BNBCalc when asked.

### Claude Code

```bash
claude mcp add --transport http --scope user bnbcalc https://atlas.bnbcalc.com/mcp
```

Run this in a terminal, then type /mcp in Claude Code, pick bnbcalc and choose Authenticate.

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "bnbcalc": {
      "url": "https://atlas.bnbcalc.com/mcp"
    }
  }
}
```

[Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=bnbcalc&config=eyJ1cmwiOiJodHRwczovL2F0bGFzLmJuYmNhbGMuY29tL21jcCJ9)

Click Add to Cursor, or save this file. Then connect bnbcalc in Cursor's MCP settings and sign in to BNBCalc.

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "bnbcalc": {
      "type": "http",
      "url": "https://atlas.bnbcalc.com/mcp"
    }
  }
}
```

[Install in VS Code](vscode:mcp/install?%7B%22name%22%3A%22bnbcalc%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fatlas.bnbcalc.com%2Fmcp%22%7D)

Click Install in VS Code, or save this file. Then start the bnbcalc server and allow the BNBCalc sign-in when VS Code asks.

### Connect with your API key

Your BNBCalc API key works too, for example in apps and scripts that can only send a fixed header. With an API subscription, open Settings → API & MCP, create a key and copy it right away: it is shown in full only once. Send it in the x-bnbcalc-api-key header; these configs have YOUR_API_KEY where it goes.

#### Claude Code

```bash
claude mcp add --transport http --scope user bnbcalc \
  https://atlas.bnbcalc.com/mcp \
  --header "x-bnbcalc-api-key: YOUR_API_KEY"
```

#### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "bnbcalc": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://atlas.bnbcalc.com/mcp",
        "--header",
        "x-bnbcalc-api-key:${BNBCALC_API_KEY}"
      ],
      "env": {
        "BNBCALC_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
```

#### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "bnbcalc": {
      "url": "https://atlas.bnbcalc.com/mcp",
      "headers": {
        "x-bnbcalc-api-key": "YOUR_API_KEY"
      }
    }
  }
}
```

#### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "bnbcalc": {
      "type": "http",
      "url": "https://atlas.bnbcalc.com/mcp",
      "headers": {
        "x-bnbcalc-api-key": "YOUR_API_KEY"
      }
    }
  }
}
```

Claude Desktop can't send a custom header on its own, so its config runs a small bridge, mcp-remote, through npx; install Node.js 18 or newer first. Open the config from Settings → Developer → Edit Config, and keep no space after the colon in x-bnbcalc-api-key:${BNBCALC_API_KEY}, since a space breaks on Windows. Then quit Claude Desktop completely and open it again.

This is the same key the REST API uses. One key works in several apps; if you regenerate it, update each app that uses it, and keep files with a key out of version control.

---

## Pair it with the apps you already use

### From a Zillow link to an offer

> Here's a Zillow listing I'm eyeing: [paste link]. Read the price and details, run a buy analysis at 20% down and 7%, and tell me the highest offer that still clears 8% cash-on-cash.

The most you can pay and still hit your return, with the full analysis behind it. With Zillow or Redfin. Tools: `get_property_details`, `create_buy_analysis`.

### Log hours from your calendar

> Go through my Google Calendar for last week, find the property visits, repairs and guest turnovers, log those hours toward material participation, and tell me how close I am to 100 hours this year.

Your hours logged without retyping, and where you stand on the 100-hour test. With Google Calendar. Tools: `log_material_participation_hours`, `get_material_participation`.

### Check the rules before you buy

> Search the web for Nashville's current short-term rental permit rules, then estimate Airbnb revenue for these three addresses and flag any that look like residential zoning.

Revenue for each address next to the rules that could block it. With web search. Tools: `estimate_revenue` ×3.

### Send a deal to your partner

> Run a buy analysis on the 3 bedroom at 21 Lake Rd, Lake Placid, NY at $600,000 with 25% down, then post a three-line summary and the report link to #deals in Slack.

Your partner sees the numbers and the full report without leaving Slack. With Slack. Tools: `create_buy_analysis`, `get_report_link`.

### Rewrite your Airbnb listing

> Optimize my Airbnb listing at [paste link]. Give me the new title and description ready to paste into Airbnb, the photo order to use, and the full audit as a PDF.

A scored audit with copy to paste, a better photo order and a PDF you can keep. With Airbnb. Tools: `run_listing_optimization`, `get_listing_optimization`, `get_listing_optimization_report_url`.

### Rank your saved Zillow homes

> Open my saved homes on Zillow, estimate Airbnb revenue for the last five I saved, rank them by revenue against list price and run a full buy analysis on the best one.

Your saved homes ranked by Airbnb potential, with the full numbers on the best one. With Zillow or Realtor.com. Tools: `estimate_revenue` ×5, `create_buy_analysis`.

---

## 31 tools

### Revenue and comps

- `estimate_revenue` (Read only): Yearly revenue, nightly rate and occupancy
- `find_comparables` (Read only): Up to 50 nearby listings with revenue
- `get_listing` (Read only): One comparable listing in detail
- `get_live_listing` (Read only): Live details of an Airbnb listing
- `get_listing_photos` (Read only): Photos of a listing

### Analyses

- `create_buy_analysis` (Saves to your account): Purchase analysis with cash flow and returns
- `create_owned_analysis` (Saves to your account): Analysis of a property you already own
- `create_arbitrage_analysis` (Saves to your account): Rental arbitrage analysis from monthly rent
- `create_cohost_analysis` (Saves to your account): Co-hosting analysis with your commission
- `enhance_analysis` (Saves to your account): Add AI comps or AI expense estimates
- `get_analysis` (Read only): Read one saved analysis
- `list_analyses` (Read only): List your saved analyses
- `get_ai_comps` (Read only): AI comp picks and reasoning
- `get_expense_estimates` (Read only): AI expense estimates
- `get_report_link` (Read only): Shareable report link

### Property and rents

- `get_property_details` (Read only): Beds, size, value and taxes for a US address
- `get_rent_estimate` (Read only): Long-term rent with comparable rentals
- `get_section8_rents` (Read only): Section 8 (HUD) and Census rents by ZIP

### Calculators

- `calculate_amortization` (Read only): Loan payment and schedule
- `calculate_dscr` (Read only): Debt service coverage ratio
- `calculate_tax_benefits` (Read only): Depreciation and tax savings
- `calculate_sell_or_refinance` (Read only): Compare selling with refinancing

### Listing Optimizer

- `run_listing_optimization` (Saves to your account): Rewrite and score an Airbnb listing
- `get_listing_optimization` (Read only): Status and score of a run
- `list_listing_optimizations` (Read only): Your past runs
- `get_listing_optimization_report_url` (Read only): Download link for a report

### Account and records

- `get_account` (Read only): Plan, credits and key status
- `get_usage` (Read only): Requests and billed usage
- `get_api_health` (Read only): Check the API is up
- `get_material_participation` (Read only): Material participation hours and tests
- `log_material_participation_hours` (Saves to your account): Log hours for a property

---

## What it can and can't do

### It can

- Read BNBCalc revenue, comps and property data
- Create and price your analyses
- Run calculators and Listing Optimizer reports

### It can't

- Log in to Airbnb or change your listings
- Share host names or other personal data
- Edit or delete your analyses

---

## Frequently asked questions

### What is the BNBCalc MCP server?

A remote server that lets AI assistants use BNBCalc through the Model Context Protocol. Your assistant picks the right tool, and you get revenue estimates, comps and deal analyses in the chat.

### Which AI tools does it work with?

Claude, ChatGPT, Claude Code, Cursor, VS Code and other MCP clients that support sign-in. Any client that can send a custom header can also connect with your BNBCalc API key.

### How do I get access?

Add the server URL to your AI client and sign in with your BNBCalc account. Free tools work right away; paid tools run after you subscribe to API access under Settings, API in your dashboard, with no monthly fee. Subscribers can also connect with their API key from the same page. MCP and REST API calls share that subscription.

### Are the numbers the same as in the BNBCalc app?

Yes. The MCP server uses the same analysis model as the app, so a revenue estimate matches the analysis you create later.

### Can it change my data?

It can create analyses and log hours for your properties, but it can't edit or delete your analyses. It never logs in to Airbnb or other platforms.
