Hotel search MCP server for Claude, ChatGPT and AI agents

Install the MCP server

Paste https://mcp.pilotplans.com/mcp wherever a client asks for a remote or custom MCP server. Setup for each client:

claude mcp add --transport http pilot https://mcp.pilotplans.com/mcp

{
  "mcpServers": {
    "pilot": { "url": "https://mcp.pilotplans.com/mcp" }
  }
}

code --add-mcp '{"name":"pilot","type":"http","url":"https://mcp.pilotplans.com/mcp"}'

{
  "servers": {
    "pilot": { "type": "http", "url": "https://mcp.pilotplans.com/mcp" }
  }
}

{
  "mcpServers": {
    "pilot": { "serverUrl": "https://mcp.pilotplans.com/mcp" }
  }
}

codex mcp add pilot --url https://mcp.pilotplans.com/mcp

[mcp_servers.pilot]
url = "https://mcp.pilotplans.com/mcp"

gemini mcp add --transport http pilot https://mcp.pilotplans.com/mcp

{
  "mcpServers": {
    "pilot": { "type": "http", "url": "https://mcp.pilotplans.com/mcp" }
  }
}

{
  "mcpServers": {
    "pilot": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.pilotplans.com/mcp"]
    }
  }
}

What to ask

Once the server is connected, ask in plain language. The assistant picks the tools.

• Find 4-star hotels near the old town in Lisbon for three nights next month, under $250 a night.
• Hotels within 2 km of Shibuya Station for 2 adults and a 6-year-old. Which rooms are refundable?
• Boutique hotels in Roma Norte, Mexico City, with a guest rating of 9 or higher.
• Compare breakfast-included rates at the top three.

In clients that render MCP Apps, including Claude and ChatGPT, hotel search results appear as photo cards with a map.

Tools

All three tools are read-only (readOnlyHint: true) and never change state, so clients can run them without asking for confirmation. The live tools/list response is the source of truth for schemas.

A typical run: search_hotels for the place and dates, get_hotel_details for the hotels worth a closer look, get_room_rates_for_hotel to price rooms, then the hotel's url so the user can book on Pilot.

Use it from your own agent

Claude API

The Messages API connects to remote MCP servers for you. Pass the server in mcp_servers and reference it from an mcp_toolset:

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-11-20" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5",
    "max_tokens": 16000,
    "mcp_servers": [
      { "type": "url", "url": "https://mcp.pilotplans.com/mcp", "name": "pilot" }
    ],
    "tools": [{ "type": "mcp_toolset", "mcp_server_name": "pilot" }],
    "messages": [
      { "role": "user", "content": "Find 4-star hotels in Lisbon for three nights next month under $250 a night." }
    ]
  }'

import anthropic

client = anthropic.Anthropic()
response = client.beta.messages.create(
    model="claude-opus-5",
    max_tokens=16000,
    betas=["mcp-client-2025-11-20"],
    mcp_servers=[{"type": "url", "url": "https://mcp.pilotplans.com/mcp", "name": "pilot"}],
    tools=[{"type": "mcp_toolset", "mcp_server_name": "pilot"}],
    messages=[{"role": "user", "content": "Find 4-star hotels in Lisbon for three nights next month under $250 a night."}],
)

OpenAI Responses API

from openai import OpenAI

client = OpenAI()
response = client.responses.create(
    model="gpt-5",
    tools=[{
        "type": "mcp",
        "server_label": "pilot",
        "server_url": "https://mcp.pilotplans.com/mcp",
        "require_approval": "never",
    }],
    input="Find 4-star hotels in Lisbon for three nights next month under $250 a night.",
)
print(response.output_text)

Raw JSON-RPC

The server is stateless and issues no session id, so you can call it directly to test. It answers with a single text/event-stream message.

curl -s https://mcp.pilotplans.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

curl -s https://mcp.pilotplans.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_hotels","arguments":{"location":"Lisbon","check_in":"2027-03-12","check_out":"2027-03-15","limit":5}}}'

Use future dates. MCP SDK clients send initialize first, which also works.

Access and booking

Free and open

No API key, account, OAuth flow or rate agreement. Connect and call in one step.

Read-only

The tools search and price hotels. They cannot hold, reserve or pay for a room, so nothing a client does here commits a user to a purchase.

Booking on Pilot

Every hotel result carries a url to that hotel on pilotplans.com with the dates and guests filled in. Send the user there to book.

Live data

Rates and availability come from Pilot's hotel suppliers when the tool is called and can change until a room is booked.

FAQ

For agents and crawlers

• /llms.txt and /llms-full.txt: LLM-oriented overview and full text
• /index.md: this page as Markdown, also returned at / for Accept: text/markdown
• /.well-known/mcp/server-card.json: MCP Server Card (also at /mcp/server-card)
• /.well-known/ai-catalog.json: AI Catalog (ARD) manifest
• /.well-known/api-catalog: RFC 9727 API catalog
• /.well-known/agent-skills/index.json: Agent Skills index, with a skill for installing and using this server
• /auth.md: authentication notes for agents (none required)
• WebMCP: this page registers the same three tools with the browser's model context, so in-browser agents can search without installing anything.