Skip to content

    For agents

    Let your assistant book the table.

    Forage exposes the same live diary the website uses as a small public API and as an MCP server. An assistant can search venues, check real times and make a booking, with no commission and no scraping.

    Three tools

    • search_venues

      Venues live on Forage, filtered by city, cuisine or a free text query. Returns names, areas, hours, price and the booking URL.

    • check_availability

      Live times for one venue, date and party size, straight from the venue's own diary in Crumbs.

    • create_booking

      Books a table for a named guest with an email or phone. The venue sees it in their diary at once and the guest gets the same confirmation as on the site.

    How to connect

    MCP server

    Streamable HTTP transport. Add it as a remote server in Claude, ChatGPT, Cursor or any MCP client.

    https://eltasuwllihnsqketgdv.supabase.co/functions/v1/forage-mcp

    No key is needed to search or check times. Bookings are rate limited per client.

    REST API

    Plain JSON over HTTPS. The OpenAPI description is at /openapi.json.

    GET  https://eltasuwllihnsqketgdv.supabase.co/functions/v1/forage-public-api/venues?city=London
GET  https://eltasuwllihnsqketgdv.supabase.co/functions/v1/forage-public-api/venues/{slug}
GET  https://eltasuwllihnsqketgdv.supabase.co/functions/v1/forage-public-api/availability?venue={id}&date=2026-11-01&covers=2
POST https://eltasuwllihnsqketgdv.supabase.co/functions/v1/forage-public-api/bookings

    Ground rules

    • Only venues that have published to Forage are returned. There is no sample data.
    • Availability is live from the venue's diary, so always check before you book; a slot can go in the time it takes to ask the guest.
    • A booking needs the guest's real name and a way to reach them. Agents must have the guest's consent to share those.
    • Deposits, where a venue asks for one, are paid by the guest on a Stripe page the booking response links to. The agent never handles card details.
    • Send a `referral_source` (for example your product name) so the venue can see where the booking came from.

    Full reference, including the booking body and error codes: docs/integrations/agents.md in the Forage repository. How Forage works.