Developer surface · MCP server

PricePulse in your AI.

Plug PricePulse data into Claude Code, Cursor, LangChain, or any MCP-compatible agent. Same credit wallet — your tool calls and your reports come out of one balance.

Get an API key → Browse 7 tools
.mcp.json Copy 
{
  "mcpServers": {
    "pricepulse": {
      "url": "https://mcp.pricepulse.io",
      "headers": {
        "Authorization": "Bearer pp_live_…"
      }
    }
  }
}
Quick start

From zero to first tool call in two minutes.

Get an API key from your dashboard, drop the server config into your client, restart, and ask your agent for a market snapshot.

1
Get your API key
In Dashboard → Settings → API key. Format: pp_live_…
2
Add to your client config
Works with Claude Desktop, Cursor, Claude Code, LangChain, and any MCP client.
3
Restart, then call a tool
Your agent gets seven tools immediately. Credit cost is reported per call.
4
Verify with a curl smoke test
Optional — hit the server directly to confirm auth before pointing your agent at it.
JSON · .mcp.jsonCopy
// Drop into ~/.config/claude/.mcp.json
{
  "mcpServers": {
    "pricepulse": {
      "url": "https://mcp.pricepulse.io",
      "headers": {
        "Authorization": "Bearer pp_live_8a91…4d2c"
      }
    }
  }
}
Available tools

Seven tools, one wallet.

The PricePulse Intelligence surface exposes seven live STR market-data tools. Each returns structured JSON; credits deduct on a successful fresh pull (cache hits don't bill). Click a row to see params and returns.

Pull live STR market intelligence for a set of Airbnb listings in ONE call — detail, calendar, review velocity, and live pricing. The master endpoint. 3–20 credits
Methodpp_get_listings(listing_ids, include_pricing, stays) +

Parameters

listing_ids*string[]Airbnb listing IDs to fetch. Batch for the best $/listing.
include_detailboolTitle, host, photos, amenities. Default true.
include_calendarboolForward availability. Default true.
include_reviewsboolReview velocity + scores. Default true.
include_pricingboolLive pricing. Requires stays. Default false.
stays{checkin,checkout}[]Required when include_pricing=true. YYYY-MM-DD.

Cost

  • 1 listing~3 credits
  • 5 listings~13 credits
  • 10+ listings20 credits (ceiling)
Deep-dive on a single Airbnb listing — title, host, photos, amenities, plus live pricing/availability if you supply dates. ~3 credits
Methodpp_get_listing_detail(listing_id, checkin, checkout, adults) +

Parameters

listing_id*string
checkinstringYYYY-MM-DD.
checkoutstringYYYY-MM-DD.
adultsint

Notes

  • cost~3 credits / call
  • tipprefer pp_get_listings for batches ≥ 2
Discover comparable Airbnb listings around a lat/lng + radius. Returns listing IDs you feed into pp_get_listings. The comp-set discovery primitive. ~2 credits
Methodpp_search_listings_by_geo(lat, lng, radius_miles, min_bedrooms) +

Parameters

lat*number
lng*number
radius_milesnumberDefault 5.
min_bedroomsint
checkin / checkoutstringYYYY-MM-DD, optional availability filter.
items_per_pageintDefault 20.

Notes

  • cost~2 credits / call
  • returnslisting IDs in radius
Forward occupancy summary across N months for a set of listings — per-month available / booked / blocked night counts. The cheapest way to gauge how booked-up a comp set is. ~3 credits
Methodpp_bulk_calendar_summary(listing_ids, months_count) +

Parameters

listing_ids*string[]
months_countint1–12. Default 3.
start_year / start_monthintOptional window start.

Notes

  • cost~3 credits / call (any batch)
  • returnsper-month night counts
Forward open-pricing windows for a set of listings — what each is asking for the next N months on currently-available dates. ~5 credits
Methodpp_bulk_listing_open_pricing(listing_ids, months_count) +

Parameters

listing_ids*string[]
months_countintHow many forward months to scan.
max_gaps / min_gap_nightsintOpen-window shaping.

Notes

  • cost~5 credits / call
  • use for"what does the comp set charge on open inventory?"
Live comp pricing for a SPECIFIC stay across a set of listings — per-listing nightly, total, and fees for checkin → checkout. ~3 credits
Methodpp_bulk_price_for_date(listing_ids, checkin, checkout) +

Parameters

listing_ids*string[]
checkin*stringYYYY-MM-DD.
checkout*stringYYYY-MM-DD.

Notes

  • cost~3 credits / call
  • use for"what would my comps charge me this weekend?"
Review velocity and scores for a set of listings — review count, average rating, recent velocity. Triangulates scraped occupancy (high occupancy + zero recent reviews usually = owner-blocked calendar, not real bookings). ~2 credits
Methodpp_bulk_review_summary(listing_ids) +

Parameters

listing_ids*string[]

Notes

  • cost~2 credits / call
  • returnscount · avg rating · recent velocity

One wallet. Reports + MCP.

Credits are fungible — buy a pack, use them anywhere. Cap your MCP spend in Settings if you're scripting heavy loops.

Cheapest tool
2 credits
pp_search_listings_by_geo
Most data per call
20 credits cap
pp_get_listings · 10+ listings
From a pack
$0.08 / credit
save 33%
On subscription
$0.05 / credit
priority queue