# Headout — MCP server on mcp.ai
> Connect your Headout account and use 8 tools for scheduling and booking straight from your AI agent. Connect with your own API key. Headout is a travel experiences and activities booking platform offering tours, attractions, and entertainment bookings worldwide.

By: mcp.ai · official
Page: https://mcp.ai/headout

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_headout?ms=1787296080000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/headout/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/headout/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/headout/skill.md
Postman collection (v2.1): https://mcp.ai/headout/postman.json

## Tools
- headout_get_product_by_id(language?: string, product_id: string, currencyCode?: string, fetch-variants?: boolean) — Tool to retrieve detailed product information by product ID. Use when you need comprehensive product details including pricing, images, location, variants, and availability.
- headout_list_categories_v2(cityCode: string, languageCode?: string) — Tool to fetch all available activity categories for a specific city using V2 API. Use when you need to list categories of activities available in a particular city location.
- headout_list_cities(limit?: integer, offset?: string) — Tool to list all active cities with pagination support. Use when you need to retrieve available cities from the Headout platform. Supports pagination through offset and limit parameters.
- headout_list_collections_v2(limit?: integer, offset?: integer, cityCode: string, languageCode?: string) — Tool to fetch all collections for a specific city using V2 API with pagination support. Use when you need to browse collections available in a particular city, with optional language-specific content 
- headout_list_inventory_by_variant(limit?: integer, offset?: string, variantId: string, endDateTime?: string, currencyCode?: string, startDateTime?: string) — Tool to retrieve available inventory and pricing for a specific product variant. Use when you need to check availability and pricing details for booking.
- headout_list_products_by_category(limit?: integer, offset?: string, language?: string, categoryId: string, currencyCode?: string) — Tool to list product listings filtered by category ID with pagination support. Use when you need to retrieve products for a specific category.
- headout_list_products_v2(limit?: integer, offset?: integer, cityCode: string, categoryId?: string, campaignName?: string, collectionId?: string, currencyCode?: string, languageCode?: string, subCategoryId?: string) — Tool to fetch products using Headout V2 API with filtering by city, collection, category, or subcategory. Use when you need to retrieve product listings for specific locations or categories with pagin
- headout_list_subcategories_v2(cityCode: string, languageCode?: string) — Tool to fetch all subcategories for a specific city using V2 API. Use when you need to list subcategories of activities available in a particular city location.

## Example prompts
- "What can I do in Headout?"
- "Show me a summary of my Headout account"

## Links
Docs: https://mcp.ai/docs/mcps/headout
Website: https://mcp.ai/mcps/headout