Ask your agent in plain language. Each of these maps to a real tool on the server.
get_inventory
Fetch real-time inventory and pricing for a specific product variant. Returns available dates, times, remaining capacity, and per-person or per-group pricing. Use this before creating a booking to find available time slots and accurate prices.
search_products
Search for tours, activities, tickets, and experiences available on Headout. Filter by city, category, subcategory, collection, or campaign. Results are ordered by best-selling and trending patterns. Returns a paginated list of product listings with names, pricing, ratings, and URLs.
get_product
Retrieve full details of a specific Headout product including images, descriptions, FAQs, reviews, variant information, and required booking fields. Each product can have multiple variants (e.g., "Skip the Line", "General Admission") with their own pricing, inventory type, and required input fields.
list_cities
List all active cities where Headout experiences are available. Returns city codes, names, and image URLs. Use city codes to filter products, categories, and collections.
list_collections
List curated collections of experiences for a given city. Collections are themed groupings (e.g., "Top Attractions", "Family-Friendly") that can be used to filter product searches.
get_booking
Retrieve details of a specific booking by its ID, or list all bookings with pagination. Returns booking status, customer details, voucher URL, and ticket links.
list_categories
List categories and subcategories of experiences for a given city. Categories (e.g., "Tickets", "Tours") and subcategories (e.g., "Landmarks", "Museums") can be used to filter product searches.
create_booking
Create a new booking on Headout using a two-step flow. Step 1 creates the booking in UNCAPTURED state to confirm availability. Step 2 captures the booking to confirm the charge. Set **captureImmediately** to true to automatically capture after creation, or set it to false and later use capture_booking to start fulfillment.
capture_booking
Capture an UNCAPTURED booking to start fulfillment, optionally assigning your partner reference ID.
reschedule_booking
Submit a request to move a booking to a new local start and end time, subject to its reschedule policy and availability. Acceptance confirms submission; it does not confirm the booking has moved.
cancel_booking
Submit a cancellation request for a booking owned by your partner account, subject to its cancellation policy. Acceptance confirms submission; it does not confirm cancellation or a refund.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Subscribe to webhook notifications for changes to messages, calendar events, and contacts. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.
List, retrieve, and cancel scheduled events. Book meetings programmatically on behalf of invitees using available time slots. Retrieve event types and their configurations. Query user availability, available time slots, busy times, and availability schedules. Create single-use scheduling links with optional overrides. List and manage invitees, mark no-shows, and access custom question responses and UTM tracking data. Manage organization memberships, invite or remove users. Retrieve routing form configurations and submissions. Subscribe to webhooks for new bookings, cancellations, and routing form submissions.
Manage email marketing audiences, campaigns, and automations. Create, send, schedule, and track email campaigns with detailed reporting on opens, clicks, and bounces. Add, update, and organize audience contacts with tags, segments, and interest groups. Set up and manage automation workflows triggered by subscriber activity or events. Connect e-commerce stores to manage customers, products, orders, and carts. Create and manage reusable email templates and landing pages. Upload and organize files for use in campaigns. Send transactional emails via the Mandrill API. Post custom events to trigger targeted automations. Configure webhooks to track subscribe, unsubscribe, profile updates, and email delivery events.
Process payments, manage orders, and handle invoices for online, in-app, and in-person commerce. Create and manage customer profiles, catalog items, inventory counts, and locations. Issue refunds, manage disputes, and track payouts. Create bookings and appointments, manage team members and timecards, handle gift cards and loyalty programs, and manage subscriptions. Save cards on file, generate checkout links, connect and control Square Terminal devices, and manage vendor/supplier information. Extend Square objects with custom attributes. Receive webhook notifications for payments, orders, customers, inventory, invoices, bookings, disputes, team changes, and more.
Manage digital and physical product sales on Gumroad. View and update product metadata, create and manage variant categories and options, and configure discount offer codes. Retrieve and filter sales data by date range for reporting. Manage subscribers and subscription lifecycles for recurring products. Refund sales, revoke or restore buyer access, and track payouts. Verify, enable, disable, and decrement license keys for purchase validation. Draft, schedule, and send audience emails to customers and followers. Read product reviews and access authenticated user profile information.
Send, read, edit, and delete messages in Microsoft Teams channels and chats, with @mentions. Create and manage teams, channels, members, and tags. Schedule and look up online meetings, read user presence, and manage Shifts schedules. Connect a Teams bot to receive and reply to messages in chats and channels.
Search and book tours, activities, attractions, and experiences in cities worldwide. Browse products by city, category, collection, or subcategory. Retrieve detailed product information including images, descriptions, reviews, variants, and pricing. Check real-time inventory and availability for specific dates and times. Create bookings with customer and passenger details, capture reservations, and submit cancellation or reschedule requests. Access localized content in multiple languages and currencies.
Common questions about connecting Headout to AI agents with Metorial.
