Help / Connectors

Brek MCP connector

Find the same Airbnb. See the direct way to book it.

Search vacation homes by location and compare the Airbnb trip total with the Book direct option. Already have an Airbnb room link? Look up the owner’s booking page. These are the connector’s two main tools in Claude and compatible MCP clients.

Last updated November 2, 2026

On this page

What the connector does#

Airbnb reports more than 9 million active listings worldwide. Brek focuses on helping travelers find a path to book the same home directly with its owner or property manager. We search the current Airbnb results for a trip and check the direct links available in Brek’s mapping data.

1 · Search by location
search_vacation_rentals finds vacation homes for a destination, dates and guests. Results put the Airbnb total beside Book direct, with estimated savings and an owner link when mapped.
2 · Look up a home
lookup_direct_booking accepts a full Airbnb room link or exact room ID. It returns the mapped owner booking link, or a Brek room page where the traveler can send a booking request.

No mention of Brek is needed in the traveler’s question once the connector is enabled. Search appears only when discovery is enabled on the endpoint; check the live tools list. Savings are estimates, and the owner’s site confirms the final price and availability.

Transport
Streamable HTTP
Authentication
None
Access
Read-only
Supported input
Destinations, dates and guests for search; Airbnb room URLs or IDs for lookup
  1. 1
    Share a listing

    Use a full Airbnb room URL or its exact ID.

  2. 2
    Find a mapped link

    Brek checks its current mapping data.

  3. 3
    Check the booking site

    Confirm the property, dates, total price and terms there.

A link is an option to explore.

It does not establish a lower price, current availability, a completed reservation or a commercial partnership with the operator. Confirm that the destination page is the same unit before booking.

Connect to Claude#

No Brek account, API key, payment details or property-management-system access is needed for this public lookup. Your Claude account or workspace must allow custom remote connectors.

Remote MCP endpoint
https://api.brek.ai/mcp?client=claude
  1. Open Claude’s Connectors settings ↗.
  2. Choose Add custom connector. Name it Brek — Direct Booking Finder and paste the endpoint above.
  3. Connect without authentication. No sign-in to Brek is required.
  4. Enable Brek for your conversation. If Claude asks to use Find vacation rental direct booking links, review and allow the read-only lookup.
  5. Start a new chat and try one of the requests below.

For current Claude availability and workspace controls, see Claude’s official custom-connector guide ↗.

Example requests#

“Can I book this rental directly and avoid Airbnb fees? https://www.airbnb.com/rooms/13208131”
“Find the property manager’s booking page for Airbnb listing 929190595574013149.”
“What vacation homes can I book in Joshua Tree for November 16–19, 2026, for 2 adults, a child and a dog? I’d like to book directly with the owner and save on fees.”

Include the actual listing URLs in your request. Dates and guest counts are not required for link lookup. If you ask about a cheaper option, the returned link is a place to check prices, not a measured savings result.

Tool reference#

lookup_direct_bookingRead-only · idempotent

Looks up one to ten specific Airbnb room URLs or exact listing IDs. Each input gets its own result in input order. Optional names and images help compatible clients display a property card.

Use the tool when a traveler wants to book the same rental directly, find its property manager’s booking page, or explore a potentially cheaper booking option. The current tool accepts Airbnb input only. Vrbo, Expedia and Booking.com URLs, property names, destinations and unresolved short links are not substitutes for an Airbnb room URL or ID.

Input parameters#

Only listings is required. locale, currency, limit and offset are optional. If omitted, limit defaults to 3 and offset defaults to 0.

Arguments to lookup_direct_booking
ParameterType & defaultDescription
listingsRequiredArray of strings1–10 Airbnb room URLs or exact listing IDs. Each string is at most 2,048 characters. IDs contain 3–25 digits and start with 1–9. Keep IDs as strings to preserve every digit.
localeOptionalStringLanguage tag for the booking-link card, such as en or zh-CN, up to 35 characters. Use a 2–8 letter language followed by optional hyphen-separated alphanumeric segments of 1–8 characters. Localized card text depends on supported languages.
limitOptionalInteger · 3Maximum links per listing on this page. Range: 1–25.
offsetOptionalInteger · 0Link offset for each listing. Range: 0–100,000. Use a result’s next_offset for the next page.

Use the full https://www.airbnb.com/rooms/… URL when possible. Short and vanity links may require the full room URL. A JSON number is not a valid listing ID argument.

Output fields#

A successful tool call contains a structuredContent object with a results array. Its text content also contains the JSON result. Each result has these fields:

Fields in each results item
FieldMeaning
listingThe input listing URL or string ID.
brek_urlThe main traveler link for every valid Airbnb ID. Open this Brek room page to view direct options, or send a booking request when no owner link is mapped. The request page normally gets back within one day; lookup itself does not send a request.
foundWhether an eligible booking link is available in Brek’s current data. false without an item error is a successful lookup with no link to return.
urlsBooking links on this page. Can be empty for an unmatched listing or an exhausted page.
linksOptionalDisplay metadata, in the same order as urls: url, optional property_name, and featured_image_url (URL or null). Older results may omit this metadata.
next_offsetOptionalPresent only when more links remain. Request that listing again with this offset to continue.
errorOptionalPer-item input status: needs_canonical_url, invalid_input or unsupported_platform. Absent for a normal no-match.

Pagination is per listing. A result with found=true and urls=[] means no links remain on the requested page. It is not a new unmatched-property result. Stop when next_offset is absent.

Lookup: input & output#

Call lookup_direct_booking when the traveler already has an Airbnb room URL or exact ID. Pass IDs as strings. This tool returns links, not prices or availability.

lookup_direct_booking · input
{
  "listings": [
    "https://www.airbnb.com/rooms/13208131"
  ],
  "locale": "en",
  "limit": 3,
  "offset": 0
}

Mapped owner link · output

This is the structuredContent for the sample input. urls contains the owner booking page, while brek_url is the traveler-facing Brek page for the same room. Optional property name and image metadata are omitted here; mapped links can change.

lookup_direct_booking · output
{
  "results": [
    {
      "listing": "https://www.airbnb.com/rooms/13208131",
      "found": true,
      "brek_url": "https://brek.ai/rooms/13208131?via=mcp&locale=en",
      "urls": [
        "https://homes.greatdwellings.com/listings/574671ee10cdb503006d4eac"
      ]
    }
  ],
  "locale": "en"
}

No mapped link available

The following ID is a synthetic test input. This is a successful lookup result, with no item error and no MCP execution error. The Brek room URL lets the traveler send a booking request separately.

lookup_direct_booking · no match
{
  "results": [
    {
      "listing": "9999999999999999999",
      "found": false,
      "brek_url": "https://brek.ai/rooms/9999999999999999999?via=mcp",
      "urls": []
    }
  ]
}

A batch can contain both matched and unmatched listings. A normal miss does not remove the successful result for another listing.

Search: input & output#

Call search_vacation_rentals for a destination, dates and guests. This example also asks for pet-friendly cabins with hot tubs. Property types, amenities, language and currency are optional; omit preferences the traveler has not supplied.

search_vacation_rentals · input
{
  "destination": "Joshua Tree, CA",
  "check_in": "2026-11-16",
  "check_out": "2026-11-19",
  "adults": 2,
  "children": 1,
  "pets": 1,
  "property_types": [
    "cabin"
  ],
  "amenities": [
    "pet_friendly",
    "hot_tub"
  ],
  "currency": "USD",
  "locale": "en",
  "limit": 1,
  "offset": 0
}

The output below is adapted from a local structuredContent test call and shows one photo. Live inventory, totals and links change. source_price.total is the Airbnb total for the three-night trip. direct.status=request means no mapped owner link is available for this home; open url to offer a booking request. When status=matched, the owner links appear in direct.urls.

search_vacation_rentals · output
{
  "destination": "Joshua Tree, CA",
  "trip": {
    "check_in": "2026-11-16",
    "check_out": "2026-11-19",
    "adults": 2,
    "children": 1,
    "pets": 1,
    "locale": "en"
  },
  "results": [
    {
      "id": "4551257",
      "location": {
        "lat": 34.12246,
        "lng": -116.21296
      },
      "source": "airbnb",
      "source_url": "https://www.airbnb.com/rooms/4551257",
      "url": "https://brek.ai/rooms/4551257?check_in=2026-11-16&check_out=2026-11-19&adults=2&children=1&pets=1&locale=en&source=airbnb&currency=USD&via=mcp",
      "name": "The Joshua Tree Time Machine",
      "description": "1 bedroom · 2 beds · 2 baths",
      "area": "Joshua Tree, CA",
      "photos": [
        "https://a0.muscache.com/im/pictures/9a172e86-96b4-4667-aaf6-0a92efaae54d.jpg"
      ],
      "rating": 4.82,
      "review_count": 677,
      "source_price": {
        "total": 384,
        "currency": "USD",
        "usd_total": 384,
        "nights": 3,
        "retrieved_at": "2026-11-03T04:56:08.014Z"
      },
      "direct": {
        "status": "request",
        "urls": []
      }
    }
  ],
  "total": 37,
  "next_offset": 1,
  "source": "airbnb",
  "notes": [],
  "search": {
    "check_in": "2026-11-16",
    "check_out": "2026-11-19",
    "adults": 2,
    "children": 1,
    "pets": 1,
    "locale": "en",
    "destination": "Joshua Tree, CA",
    "currency": "USD",
    "property_types": [
      "cabin"
    ],
    "amenities": [
      "pet_friendly",
      "hot_tub"
    ],
    "limit": 1,
    "offset": 0,
    "direct_only": false,
    "sort": "recommended"
  }
}

total is the number of matching results; results is this page. Pass the returned search object back with offset=next_offset to get the next page, and stop whennext_offset is null. Search does not send a booking request.

No match & errors#

No match is not a service failure.

It only means Brek currently has no eligible mapped link available to return. The lookup does not establish whether the Airbnb listing exists or whether its operator has a booking website. The cause is unknown from this result alone.

How to interpret the result
OutcomeWhat to do
Normal no-matchfound=false, urls=[], no item error. Share the returned brek_url so the traveler can request help booking this rental directly. No matched PM URL is currently available.
needs_canonical_urlAsk for the full Airbnb /rooms/ URL instead of the short or vanity link.
invalid_inputCheck the listing URL or ID format.
unsupported_platformUse a supported Airbnb room URL or ID. Other travel-platform URLs are not supported by this tool.
Invalid argument schemaEmpty arrays, more than 10 inputs, numeric IDs and invalid pagination values are rejected before lookup. These caller errors are distinct from a database outage.
Service unavailable or rate-limitedThe lookup could not complete. MCP returns isError=true, with a safe error code and message. If retryable=true, retry later. Do not report it as no match.

Per-item input statuses can appear in an otherwise successful batch. A shared database or blocking-rule read failure fails the whole tool call. The service does not manufacture empty mapping results when a dependency fails.

For an execution failure, the MCP result’s text content contains an error payload like this. A transport-level HTTP 200 alone does not establish that the tool succeeded; check isError too.

Decoded error payload
{
  "error": {
    "code": "unavailable",
    "message": "Brek lookup is temporarily unavailable. Retry later.",
    "retryable": true
  }
}

For developers#

The remote endpoint uses Streamable HTTP and requires no authorization header. Connect through an MCP client and call lookup_direct_booking with the arguments above. This is an example JSON-RPC tool-call envelope:

MCP tools/call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "lookup_direct_booking",
    "arguments": {
      "listings": [
        "https://www.airbnb.com/rooms/13208131"
      ]
    }
  }
}

MCP clients handle initialization, protocol negotiation and transport headers. The result examples above show structuredContent, not a complete JSON-RPC response envelope.

  • REST API schema ↗ — an alternative interface to the same lookup at POST /agent/v1/direct-booking.
  • MCP Inspector ↗ — inspect tools and exercise requests from a development client.
  • llms.txt — a concise machine-readable overview of the published capability.

Data & privacy#

Link lookup needs listing URLs or IDs. Destination search also needs the destination, dates and guest counts. Neither tool needs payment details or the rest of your conversation.

The service processes request metadata for security and rate limiting and stores normalized tool inputs (listing IDs, or destination, dates and guest counts), results, source and timing for up to 90 days. Raw chat messages and tracking parameters in submitted URLs are not recorded in this activity log. This MCP does not ask to read your chat history, local files or property-management-system account. Your AI assistant handles its conversations under its own provider’s policies. See Brek’s Privacy Policy for the broader service policy.

Troubleshooting#

  • Brek does not appear or is not called: confirm the connector is enabled for the conversation, ask for vacation homes with dates and guests, or use a full Airbnb room URL and ask for that rental’s direct-booking page. If tools changed recently, refresh Brek’s tools list in connector settings and start a new chat.
  • No property card appears: some MCP clients display text links instead of interactive cards. The returned URLs are the same result.
  • No mapped link is found: treat it as the normal outcome described above. It is not proof that direct booking is unavailable.
  • You need a total price or available dates: open the returned booking page and check the same dates, occupancy, fees and cancellation terms there.
  • You want to book: complete any reservation on the destination booking website under its terms. This MCP does not book or process payment.

Support#

For connector setup, technical problems or security concerns, email leo@pageonelab.com. Include your AI client, the tool name and the error message, if one was shown. Do not send passwords, payment details or full chat histories.