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

federation-mcp-server