`str_listings`

Pack: inside-airbnb · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/str_listings for the schema, then POST the same URL with its arguments for the data.

Filterable listing-level rows (price, room type, neighbourhood, reviews, availability) for one city.

Tool description as the model sees it

Listing-level short-term rental rows for one city, from Inside Airbnb: listing id, public listing URL, listing title, neighbourhood, room type, nightly price (in that city’s own local currency — see the response’s currency field, never converted; min_price/max_price filter in that same currency), minimum nights, review counts, last review date, availability_365, and the host’s total listing count (a bare number — no host name, no host id, no host profile link; see the pack’s “Personal data” note). Pass city plus any combination of neighbourhood, room_type (“Entire home/apt”, “Private room”, “Shared room”, “Hotel room”, or a loose match like “apartment”), min_price, max_price to narrow. Rows beyond limit are reported via truncated/total_matching rather than silently dropped — narrow the filters or page with limit/offset to see the rest. An uncovered city is refused by name, listing every covered city.

Parameters

Name	Type	Required	Description
`city`	string	yes	City name or slug, e.g. “Paris”, “NYC”, “san-francisco”.
`neighbourhood`	string	no	Optional: filter to one neighbourhood (case-insensitive exact match).
`room_type`	string	no	Optional: “Entire home/apt”, “Private room”, “Shared room”, “Hotel room” (loose matches like “apartment” or “house” also work).
`min_price`	number	no	Optional: minimum nightly price.
`max_price`	number	no	Optional: maximum nightly price.
`limit`	number	no	Max rows to return, 1-200. Default 50. A truncated response carries truncated:true and total_matching.
`offset`	number	no	Pagination offset. Default 0.

Example call

Arguments

{
  "city": "New York City",
  "room_type": "Private room",
  "limit": 5
}

curl

curl -X POST https://gateway.pipeworx.io/inside-airbnb/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"str_listings","arguments":{"city":"New York City","room_type":"Private room","limit":5}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('str_listings', {
  "city": "New York City",
  "room_type": "Private room",
  "limit": 5
});

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the inside-airbnb pack

{
  "mcpServers": {
    "inside-airbnb": {
      "url": "https://gateway.pipeworx.io/inside-airbnb/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

str_listings