Docs·Overview

Build on the AI transaction layer for travel.

reservations.ai is the MCP and API surface behind billions in annual travel commerce. Plug in once. Sell travel across voice, SMS, messaging, social, and agents.

ALL SYSTEMS OPERATIONAL·UPTIME 99.98% (30D)

Three ways in

Pick the path that matches how you want to integrate. Every tier uses the same underlying platform · 1.5M+ properties, 27 languages, 9M+ high converting reservation calls trained into one brain.

MCP

Model Context Protocol server. 11 tools live. Connect Claude, Cursor, Windsurf, or any MCP client in 30 seconds.

REST API

Traditional HTTP endpoints for search, reserve, cancel, and reconcile. OpenAPI 3.1 spec, full SDK coverage.

Agent registration

Machine only path. POST /agents/register, receive credentials, load AEC pool, start transacting.

Authentication

Every request is authenticated with a bearer token tied to your partner tier. The public MCP endpoint is open for discovery; the authenticated endpoint opens reservation creation, reconciliation, and webhooks.

request.sh

cURLJavaScriptPython

# Authenticated MCP endpoint
curl https://mcp.reservations.com/mcp \
  -H "Authorization: Bearer $RESAI_KEY" \
  -H "Content-Type: application/json" \
  -d {
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "search_properties",
      "arguments": {
        "destination": "West Palm Beach, FL",
        "checkin": "2026-06-20",
        "checkout": "2026-06-27",
        "guests": 2
      }
    }
  }'

NOTE

Zero upfront. Reservation Partners pay nothing until a reservation completes. Rev share is variable and negotiated at signup via eSign auto contract.

Core endpoints

Six tools live in the public MCP. Add authentication to open up reservation creation, cancellation, webhooks, and reconciliation.

Method	Path	Purpose	Tier
GET	/public/mcp	Server discovery · lists all available tools and schemas	Public
POST	/mcp/tools/search_properties	Search 1.5M+ properties by destination, dates, filters	Public
POST	/mcp/tools/get_rates	Live rates with taxes, fees, cancellation policy	Public
POST	/mcp/tools/create_booking	Atomic reservation with payment tokenization	Reservation+
POST	/mcp/tools/cancel_booking	Cancellation respecting property policy	Reservation+
POST	/agents/register	Machine only agent registration · returns keys + AEC pool	Reservation+
GET	/autonomous/manifest	Machine readable capability manifest for AI operating systems	Public

Response shape

Responses follow the JSON RPC 2.0 spec for MCP calls and standard REST conventions for the HTTP API. Every response includes a request_id for reconciliation and support.

response.json

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [{
      "type": "resource",
      "resource": {
        "uri": "resai://search/a7f3e2",
        "mimeType": "application/json",
        "text": {
          "results": 247,
          "request_id": "req_01HZ8K3...",
          "properties": [...]
        }
      }
    }]
  }
}

Keep going

Get an API key · Register a partner account and receive credentials for the authenticated MCP endpoint.

Read the MCP manifest · Full schema, per tool parameter reference, error codes.

Test in the sandbox · Hit the public endpoint right now without credentials. Six tools. No commitment.

Talk to an integrations engineer · Complex partnership? Reserve a 30 minute scoping call with our team.