{"openapi":"3.1.0","info":{"title":"Holiday Globe Public Agent & Catalog API","version":"1.0.0","summary":"Read-only UK travel catalog, Markdown feeds, and Model Context Protocol (MCP) API for Holiday Globe (ATOL 11087).","description":"Public machine-readable APIs for Holiday Globe (https://www.holidayglobe.co.uk), an authorized UK online travel agency (TRAVELOPEDIALTD, CAA ATOL License 11087). All monetary values are denominated in Great British Pounds (GBP / £) with qualifying package deposits starting from £19pp.","contact":{"name":"Holiday Globe Developer & Agent Support","url":"https://www.holidayglobe.co.uk/developers","email":"admin@holidayglobe.co.uk"}},"servers":[{"url":"https://www.holidayglobe.co.uk","description":"Production UK Server"}],"paths":{"/api/mcp":{"get":{"operationId":"getMcpManifest","summary":"Retrieve MCP Server Discovery Manifest","responses":{"200":{"description":"MCP server capabilities and tool definitions","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"operationId":"invokeMcpJsonRpc","summary":"Streamable HTTP MCP JSON-RPC 2.0 Endpoint","description":"Supports initialize, notifications/initialized, ping, tools/list, and tools/call.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"type":"string","const":"2.0"},"id":{"type":["string","number","null"]},"method":{"type":"string"},"params":{"type":"object"}}}}}},"responses":{"200":{"description":"JSON-RPC 2.0 response payload"},"202":{"description":"JSON-RPC notification accepted"}}}},"/.well-known/mcp":{"get":{"operationId":"getWellKnownMcp","summary":"Well-Known MCP Discovery Manifest","responses":{"200":{"description":"MCP discovery metadata JSON"}}}},"/llms.txt":{"get":{"operationId":"getLlmsTxt","summary":"Root LLM Manifest & Agent Instructions","responses":{"200":{"description":"Markdown manifest with when-to-use guidance and primary UK destination links","content":{"text/markdown":{"schema":{"type":"string"}}}}}}},"/api/markdown/home":{"get":{"operationId":"getHomeMarkdown","summary":"Homepage Markdown Feed","responses":{"200":{"description":"Structured Markdown summary of Holiday Globe homepage","content":{"text/markdown":{"schema":{"type":"string"}}}}}}},"/api/markdown/hotel":{"get":{"operationId":"getHotelMarkdown","summary":"Hotel Detail Markdown Feed","parameters":[{"name":"country","in":"query","required":false,"schema":{"type":"string","default":"spain"}},{"name":"city","in":"query","required":false,"schema":{"type":"string"}},{"name":"slug","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Markdown hotel specification and GBP pricing"},"404":{"description":"Markdown 404 when hotel slug is not found"}}}},"/api/markdown/destination":{"get":{"operationId":"getDestinationMarkdown","summary":"Destination or Country Package Markdown Feed","parameters":[{"name":"country","in":"query","required":true,"schema":{"type":"string"}},{"name":"city","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["country"]}},{"name":"departure","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Markdown destination guide, climate table, and UK flight times"}}}},"/api/markdown/guide":{"get":{"operationId":"getGuideMarkdown","summary":"Editorial Travel Guide Markdown Feed","parameters":[{"name":"slug","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Markdown editorial guide"},"404":{"description":"Markdown 404 when guide is not found"}}}}}}