{
  "markdown": "# GetExperience MCP Server\n\nMCP server for [GetExperience.com](https://getexperience.com) — a marketplace of tours and unique travel experiences in 40+ countries.\n\nSearch, browse, and book real tours and activities directly from any AI assistant via the Model Context Protocol.\n\n## Who is this for\n\n- **AI assistants and chatbots** — add travel booking capabilities to your product\n- **Travel agencies and concierge services** — automate tour search and booking through AI\n- **Developers building AI agents** — plug in a ready-made travel API via MCP\n\n### Free access (no API key)\n\nBrowse the full catalog: search experiences, view details, check schedules and pricing. Works out of the box — just connect to the endpoint. Instant payment and booking for anyone through the chat — coming soon.\n\n### B2B partner integration\n\nBook tours on behalf of your customers — instant confirmation, no guest payment required. Your company settles with GetExperience separately (invoice/balance).\n\n**To get started as a B2B partner, contact us at [bookings@getexperience.com](mailto:bookings@getexperience.com) — we'll issue your API key the same day.**\n\n## Server URL\n\n```\nhttps://getexperience.com/mcp\n```\n\nTransport: **Streamable HTTP** (since v0.7.0). No installation required — it's a hosted remote server.\n\n> **Migrating from SSE?** See [CHANGELOG.md](CHANGELOG.md#v070--2026-04-07--streamable-http-transport) for the full before/after comparison.\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"getexperience\": {\n      \"type\": \"streamablehttp\",\n      \"url\": \"https://getexperience.com/mcp\"\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"getexperience\": {\n      \"type\": \"streamablehttp\",\n      \"url\": \"https://getexperience.com/mcp\"\n    }\n  }\n}\n```\n\n### Any MCP Client\n\nPoint your MCP client to:\n```\nhttps://getexperience.com/mcp\n```\n\nNo API key required for browsing. For B2B booking, add `X-Api-Key` header:\n\n```json\n{\n  \"mcpServers\": {\n    \"getexperience\": {\n      \"type\": \"streamablehttp\",\n      \"url\": \"https://getexperience.com/mcp\",\n      \"headers\": {\n        \"X-Api-Key\": \"YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `search_experiences` | Search tours by location, category, date, price, guests, language |\n| `get_experience_details` | Full details: description, photos, pricing, duration, languages, rating |\n| `get_experience_schedule` | Available time slots and pricing for a specific date |\n| `add_to_checkout` | Add an experience to the cart |\n| `get_checkout` | View current cart contents |\n| `create_order` | Place the final booking (B2B instant or B2C via Stripe) |\n\nFull parameters, response schemas, and examples: **[TOOLS.md](TOOLS.md)**\n\n## Booking Flow\n\n```\nsearch_experiences → get_experience_schedule → add_to_checkout → create_order\n```\n\n1. **Search** — find experiences by location, category, dates\n2. **Schedule** — pick a date, get available time slots with prices\n3. **Add to cart** — choose a slot, specify guests\n4. **Order** — place the booking (B2C via Stripe, or B2B with API key)\n\n### B2C (Guest pays by card)\n\nSet `paymentSystem: \"stripe\"` in `create_order`. Returns a Stripe payment link — the guest completes payment there. *(Coming soon)*\n\n### B2B (Partner integration)\n\nSet `paymentSystem: \"internal\"` and provide `X-Api-Key` header at connection time. Booking is confirmed instantly, host is notified by email.\n\nContact [bookings@getexperience.com](mailto:bookings@getexperience.com) to get your API key.\n\n## Response Format\n\nAll tools support two response formats via the `responseFormat` parameter:\n\n- **`\"markdown\"`** (default) — Human-readable text + `[GXP_STRUCTURED]` JSON block for programmatic use\n- **`\"json\"`** — Pure JSON only\n\n### Structured Data\n\nWhen using markdown format, every response includes a `[GXP_STRUCTURED]` block with typed JSON:\n\n```javascript\nconst match = text.match(/\\[GXP_STRUCTURED\\]([\\s\\S]*?)\\[\\/GXP_STRUCTURED\\]/);\nconst data = match ? JSON.parse(match[1].trim()) : null;\n```\n\n## Health Check\n\n```\nGET https://getexperience.com/mcp/health\n```\n\n## Links\n\n- **Website:** [getexperience.com](https://getexperience.com)\n- **MCP Endpoint:** `https://getexperience.com/mcp`\n- **Contact:** [bookings@getexperience.com](mailto:bookings@getexperience.com)\n\n## License\n\nMIT\n",
  "bytes": 4425,
  "sha": "40c018844666b9b2204f2ae9c05a0d8f368f2d8185130a675eb2b379a749a7cf",
  "repo_slug": "skurakov/getexperience-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_skurakov_getexperience_b7f7f0cd/readme"
}