Federation MCP Server

MCP server for vacation rental direct bookings. Search properties, check availability, get real-time pricing quotes, and create bookings through the federation protocol.

Supports seasonal pricing, guest-count tiers (staircase model), weekly/biweekly package discounts, gap-night discounts, and host-controlled federation discounts.

Install via Smithery

npx -y @smithery/cli install @info-00wt/federation-mcp-server --client claude

Tools

Tool	Description	Read-only
search_properties	Search vacation rentals by location, dates, and guest count. Returns available properties with live pricing (public + federation rates).	Yes
check_availability	Check if a property is available for specific dates. Verifies blocked dates, bookings, and booking locks.	Yes
get_canonical_quote	Get detailed pricing: publicTotal (website rate), federationTotal (direct booking rate), gapTotal (gap-night discount). Per-night breakdown included.	Yes
create_booking	Create a direct booking at federation price. Validates availability, calculates price, creates pending booking for host approval.	No
negotiate_offer	Create a binding price quote with quoteId. Stores immutable snapshot, expires after 15 minutes. Pass quoteId to checkout to lock the price.	Yes
checkout	Create a booking with Stripe payment. Supports MPP (payment_intent mode for programmatic payment). Optionally locks price via quoteId.	No
cancel_booking	Cancel a booking. Handles refund calculation, Stripe refund, email notifications via Supabase Edge Function.	No
get_booking_status	Get booking details, property info, and cancellation policy by reservation ID.	Yes
reschedule_booking	Reschedule to new dates. Checks availability, recalculates price, handles Stripe charge/refund for price delta.	No

Pricing Architecture

Host sets prices, seasons, guest tiers, federation discount
         ↓
    property node (Supabase — source of truth)
         ↓
  MCP Server reads live data — never cached, never estimated
         ↓
  AI agents → federation_total (direct booking discount)
  Websites → public_total (standard rate)
  Gap nights → gap_total (calendar-context discount)

Price Tiers

Scenario	Price	How
Website / public	publicTotal	Sum of nightly rates per season, guest tier, and day type
Federation / direct booking	federationTotal	publicTotal × (1 - host_discount%)
Gap night (between bookings)	gapTotal	federationTotal × (1 - gap_discount%)

Guest-count pricing uses a staircase model (e.g. 1-2 guests, 3-4, 5-6). The host controls all discount percentages — nothing is hardcoded.

Setup

npm install

Create .env from .env.example:

cp .env.example .env
# Fill in SUPABASE_URL and SUPABASE_SERVICE_ROLE_KEY
# Optionally add STRIPE_SECRET_KEY for checkout/cancel/reschedule tools

Required environment variables:

• SUPABASE_URL — Your Supabase project URL
• SUPABASE_SERVICE_ROLE_KEY — Service role key (full database access)

Optional (enables Stripe-powered tools):

• STRIPE_SECRET_KEY — Enables checkout, cancel_booking, and reschedule_booking tools

Agentic Commerce Protocol (ACP)

First vacation rental with Stripe ACP support. AI agents can complete bookings with SharedPaymentTokens — no redirect, no manual payment.

Endpoint	Method	Purpose
/acp/checkouts	POST	Create checkout session
/acp/checkouts/:id	GET	Retrieve checkout state
/acp/checkouts/:id	PUT	Update (dates, guests, buyer)
/acp/checkouts/:id/complete	POST	Complete with SharedPaymentToken (spt_) or PaymentMethod (pm_)
/acp/checkouts/:id/cancel	POST	Cancel checkout + refund

Supports Stripe SharedPaymentTokens (SPT), Klarna, Swish, and card payments. Compatible with ChatGPT Instant Checkout, Google UCP, and any ACP-compliant agent.

MCP + ACP Endpoints

Path	Method	Purpose
/mcp	POST	MCP Streamable HTTP endpoint
/mcp	GET	Transport info
/acp/checkouts	POST/GET/PUT	ACP checkout lifecycle
/health	GET	Health check
/.well-known/mcp.json	GET	MCP discovery metadata
/.well-known/mcp/server-card.json	GET	Smithery server card

Transport

Streamable HTTP (POST /mcp) — required for Smithery Gateway and remote MCP clients. Stateless (no session management needed).

License

MIT