Tock MCP server for AI agents

Let Claude, ChatGPT or your own agent read Tock: 5 typed functions through one MCP server. No Tock API key needed.

Functions
5
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just Tock

An MCP server for Tock alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/tock
Every site

One MCP server for Tock and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 5
  • findBusinessSearch for a Tock venue by name, city or other criteria.

    Arguments

    NameTypeRequired
    querystringYes

    Returns TockBusinessSuggestion[]

    interface TockBusinessSuggestion {
      slug: string;          // pass this to getBusiness
      name: string;
      city: string;
      state: string;
      country: string;
      neighborhood: string | null;
      imageUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tock/findBusiness

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tock.findBusiness("Onsen");
  • getBusinessRetrieve full details of one Tock venue including name, location, hours and description.

    Arguments

    NameTypeRequired
    slugstringYes

    Returns TockBusiness

    interface TockBusinessHours {
      weekday: string;       // e.g. "MONDAY"
      serviceType: string;   // e.g. "DINNER"
      startTime: string;     // "HH:MM"
      endTime: string;       // "HH:MM"
    }
    
    interface TockBusiness {
      id: number;
      slug: string;          // the business's own URL slug, what every function on this provider takes
      name: string;
      description: string;
      address: string;
      city: string;
      state: string;
      zipCode: string;
      country: string;
      cuisines: string;
      priceRange: string;    // e.g. "$$"
      phone: string;
      website: string;
      timeZone: string;
      acceptsWalkins: boolean;
      hours: TockBusinessHours[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tock/getBusiness

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tock.getBusiness("onsenurbanbathandrestaurant");
  • getExperienceGet details of one experience including description, price and party size limits.

    Arguments

    NameTypeRequired
    businessSlugstringYes
    experienceSlugOrIdstringYes

    Returns TockExperienceDetail

    interface TockExperience {
      id: number;
      slug: string;          // e.g. "co-ed-bathhouse"
      name: string;
      type: string;          // "PRIX_FIXE" (timed reservation) | "GA_EVENT" (ticketed event) | …
      description: string;
      priceDescription: string;  // the venue's own label, e.g. "$50 per person"
      pricePerPersonCents: { min: number; max: number } | null;
      currencyCode: string;
      partySizes: number[];  // party sizes it accepts, e.g. [1, 2, 3, 4]
      state: string;         // "AVAILABLE" | "SOLD"
      isOneTimeEvent: boolean;
    }
    
    interface TockExperienceLocation {
      name: string;
      address: string;
      city: string;
      state: string;
      zipCode: string;
      country: string;
    }
    
    interface TockSeatingArea {
      name: string;
      minPartySize: number;
      maxPartySize: number;
    }
    
    interface TockExperienceDetail extends TockExperience {
      images: string[];             // every photo Tock shows for this experience
      seatingAreas: TockSeatingArea[];
      cancellationPolicyText: string;
      canTransfer: boolean;
      location: TockExperienceLocation | null;
      minRequiredSpendCents: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tock/getExperience

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tock.getExperience("bogle", "home-ranch-tasting-experience");
  • listExperiencesList all experiences (timed slots) available at a specific venue.

    Arguments

    NameTypeRequired
    slugstringYes

    Returns TockExperience[]

    interface TockExperience {
      id: number;
      slug: string;          // e.g. "co-ed-bathhouse"
      name: string;
      type: string;          // "PRIX_FIXE" (timed reservation) | "GA_EVENT" (ticketed event) | …
      description: string;
      priceDescription: string;  // the venue's own label, e.g. "$50 per person"
      pricePerPersonCents: { min: number; max: number } | null;
      currencyCode: string;
      partySizes: number[];  // party sizes it accepts, e.g. [1, 2, 3, 4]
      state: string;         // "AVAILABLE" | "SOLD"
      isOneTimeEvent: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tock/listExperiences

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tock.listExperiences("bogle");
  • searchBusinessesEvery Tock venue in one city or metro area, browsed through the site's own city page.

    Arguments

    NameTypeRequired
    cityNamestringYes

    Returns TockCityVenue[]

    interface TockCityVenue {
      slug: string;          // pass this to getBusiness
      name: string;
      cuisine: string;
      priceRange: string;    // e.g. "$$"
      city: string;          // the venue's own city, may differ from the query across a metro area
      state: string;
      country: string;
      neighborhood: string;
      website: string;
      imageUrl: string | null;
      timeZone: string;
      currencyCode: string;
      businessType: string;  // e.g. "Restaurant"
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/tock/searchBusinesses

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.tock.searchBusinesses("Chicago");

Use it from code