Connect

Plug Holiday Forever into your AI assistant.

Holiday Forever is an MCP server. Add the endpoint to Claude, ChatGPT, or any MCP-compatible client and your assistant can browse and recommend listings from the directory.

MCP endpoint

https://holiday-forever-2.vercel.app/mcp
transport: streamable-http auth: none protocol: 2025-06-18

For humans — add the connector

Pick your client and follow the steps. The endpoint is the same everywhere.

  1. Open Claude (desktop or web).
  2. Go to Settings → Connectors → Add custom connector.
  3. Paste the URL: https://holiday-forever-2.vercel.app/mcp
  4. Save. Start a new chat and ask, “Show me a holiday listing.”
Open Claude connector settings →
  1. In your terminal, run:
# Add as a project-scoped MCP server
claude mcp add holiday-forever https://holiday-forever-2.vercel.app/mcp \
  --transport http
  1. Open Claude Code in this project and verify with /mcp.
  1. Open ChatGPT.
  2. Go to Settings → Connectors → Add custom connector (Plus / Team / Enterprise required).
  3. Paste the URL: https://holiday-forever-2.vercel.app/mcp
  4. Authentication: None. Save and enable it in a new chat.
  1. Open Cursor → Settings → MCP → Add new MCP server.
  2. Paste the URL and pick the http transport.
// ~/.cursor/mcp.json
{
  "mcpServers": {
    "holiday-forever": {
      "url": "https://holiday-forever-2.vercel.app/mcp",
      "transport": "http"
    }
  }
}

Any client that speaks the MCP Streamable HTTP transport works. Drop this config in wherever your client expects MCP servers:

{
  "mcpServers": {
    "holiday-forever": {
      "url": "https://holiday-forever-2.vercel.app/mcp",
      "transport": "streamable-http"
    }
  }
}
Once connected: Try asking the assistant: “Show me the holiday listing” or “Book a stay at the Holiday Forever property.”

For AI agents — endpoint & tools

If you are an AI agent reading this page to bootstrap a connection, use the values below. The same metadata is exposed at /.well-known/mcp.json and in this document’s <meta> tags.

{
  "name": "holiday-forever",
  "title": "Holiday Forever",
  "description": "Directory of Airbnb-style holiday listings, served as MCP.",
  "endpoint": "https://holiday-forever-2.vercel.app/mcp",
  "transport": "streamable-http",
  "protocolVersion": "2025-06-18",
  "authentication": "none",
  "tools": ["show_listing", "book_listing"]
}

show_listing

Renders a listing as an interactive photo-gallery widget (hero image, thumbnails, price, rating, summary, booking link). Falls back to markdown on hosts that don’t render MCP App widgets. No arguments.

book_listing

Holds a mock reservation for the listing and returns a confirmation card. Usually invoked by the widget’s “Book this stay” button rather than directly.

Verify the connection

Smoke-test the endpoint from a terminal:

# Initialize handshake
curl -s -X POST https://holiday-forever-2.vercel.app/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'