Book From Locals — AI Integration (MCP Server)

Public Model Context Protocol (MCP) server for Book From Locals. Search 300+ tours across 21 destinations in Turkey, Greece, and Spain, and create real bookings directly from your AI assistant — no online payment, you pay the guide on the tour day.

We believe this is the first European tour operator to expose a native MCP integration for end-user booking.

What this is

Book From Locals operates a public MCP server at https://bookfromlocals.com/mcp. AI assistants — Claude (Pro / Max / Team / Enterprise), and any other MCP-compatible client — can use it to:

Browse all 21 tour destinations
Search and filter 300+ tours by city, category, date, guests
Get full tour details including pickup zones and pricing
Check date availability with live pickup times
Create a Pay-Later booking — instant confirmation, no online payment

For Claude users — adding the connector

The connector is available on Claude Pro, Max, Team, and Enterprise plans (custom connectors are not available on the Free plan).

Open Claude (claude.ai, Desktop, or mobile) → Settings → Connectors → Add custom connector
Paste the URL: https://bookfromlocals.com/mcp
Save and enable in any conversation via the + button

No account creation, no API key, no setup beyond the URL paste. The connector works across all your Claude surfaces once added.

Example prompts

“List all destinations on Book From Locals”
“What tours are available in Antalya?”
“Tell me about the Antalya White Water Rafting tour”
“Is tour 19965 available on June 15?”
“Book that tour for 2 adults on June 15. Name: Jane Doe, jane@example.com, +44…”

Claude will read tour data automatically and confirm details with you before creating a booking.

Available tools

Tool	What it does	Type
`list_destinations`	Returns all 21 destinations with current tour counts	Read-only
`search_tours`	Searches tours with filters (destination, category, date, guests, currency)	Read-only
`get_tour_details`	Full details for one tour — packages, pickup zones, schedule	Read-only
`check_availability`	Checks a specific date, returns pickup times + per-pax prices	Read-only
`create_booking`	Creates a Pay-Later booking with guest contact details	Write — requires confirmation

The four read-only tools are annotated readOnlyHint: true and execute without per-call confirmation. create_booking is annotated destructiveHint: true — Claude prompts the user to confirm details before each booking.

How booking works

AI assistant calls check_availability to confirm the date is bookable and get pickup times
AI assistant confirms booking details with the user (tour, date, guests, contact info)
AI assistant calls create_booking. Tour ID, date, guest counts, and contact details are sent to our REST API
We create a pending booking immediately and return a booking ID + WhatsApp follow-up link
Our team reaches out via WhatsApp within 24 hours to finalize pickup time and hotel logistics
The customer pays the guide directly on the tour day — no online payment is processed

Free cancellation is available up to the tour day at no charge.

For developers — REST API

The MCP server is a thin wrapper around our public REST API:

Endpoint	Method	Auth	Purpose
`/wp-json/bfl/v1/health`	GET	Public	Liveness — returns tour count and last-booking timestamp
`/wp-json/bfl/v1/destinations`	GET	Public	All 21 destinations grouped by country
`/wp-json/bfl/v1/tours`	GET	Public	Search with filters and pagination
`/wp-json/bfl/v1/tours/{id}`	GET	Public	Full tour detail (zones, packages, available dates)
`/wp-json/bfl/v1/availability`	GET	Public	Date + hotel-aware price check
`/wp-json/bfl/v1/bookings`	POST	API key	Create a Pay-Later booking

Live status: https://bookfromlocals.com/wp-json/bfl/v1/health

The same REST API powers our planned ChatGPT GPT Action and Gemini Extension — let us know if you’d like early access.

Authentication & privacy

Authentication model

Read tools (4 of 5): No authentication required. Public endpoints; rate-limited per IP (100 req/min).
Write tool (create_booking): Authenticated server-to-server. The MCP server holds a single shared API key issued by Book From Locals; end users (Claude users booking a tour) do not need to log in or create an account. Booking is guest-checkout style with contact details provided at the time of booking.

Data we collect

When you create a booking via the connector:

Name, email, phone — to confirm pickup and reach you in case of last-minute schedule changes
Tour ID, date, guest counts — to fulfill the booking
Hotel name (optional) — used to match the right pickup zone if your tour has zone-based pricing
Channel attribution — we record that the booking came via Claude MCP (bfl_source: claude_mcp) for our own analytics

We do not:

Store your conversation history with the AI assistant
Track your AI usage outside the booking events themselves
Share data with third parties beyond what’s needed to fulfill the booking

Full privacy policy: https://bookfromlocals.com/privacy-policy/

TURSAB licensed

Book From Locals is operated by Beşem Turizm Travel Agency, holder of TURSAB License No. 4278. License verification: https://www.tursab.org.tr/tr/ddsv

For Anthropic reviewers

This connector was built specifically with the Connectors Directory in mind. A few things to make review easier:

Test the 4 read tools without any setup — they are public and require no credentials. Just point any MCP client at https://bookfromlocals.com/mcp and call them.
For create_booking testing: the production API will create real bookings. Please contact us at info@bookfromlocals.com with the subject line “Connectors Directory review” and we’ll either:
- Provide a sandbox API key that honors dry_run: true payloads (preview-only, no DB write), or
- Authorize a single review booking that we’ll clean up afterward.
Support response time: under 24 hours for review-related inquiries. Email info@bookfromlocals.com.

Support

Email: info@bookfromlocals.com
WhatsApp: https://wa.me/905014955457 (+90 501 495 54 57)
Office: Beşem Turizm Travel Agency, Muğla, Turkey
Status: https://bookfromlocals.com/wp-json/bfl/v1/health
Machine-readable summary: https://bookfromlocals.com/llms.txt

Changelog

2026-05-27 — v2.0.0 — Production launch. 6 REST endpoints, 5 MCP tools, tool annotations added for Connectors Directory compliance.

Select your currency

All currencies