Skip to main content
Glama
tock-mcp

tock-mcp

by chrischall

tock-mcp

MCP server for Tock (exploretock.com) — restaurant discovery and availability for Claude. List cities, search a metro, and get a venue's details plus its bookable experiences, prices, party sizes, and open dates/times.

Every request is relayed through your own signed-in browser tab via the ContextMint Bridge browser extension — no cookie paste, no bot-wall dance, no password handling. This project was developed and is maintained by AI (Claude Code).

Tock publishes no official consumer API, and exploretock.com sits behind a Cloudflare challenge. tock-mcp fetches the same server-rendered pages the Tock web app uses (parsing their embedded window.$REDUX_STATE store) through your signed-in tab. It is read-only — Tock reservations are prepaid tickets, so booking stays on exploretock.com. Use at your own discretion.

Install

// .mcp.json
{
  "mcpServers": {
    "tock": { "command": "npx", "args": ["-y", "tock-mcp"] }
  }
}

You also need ContextMint Bridge (the browser extension shared by every fetchproxy-based MCP), installed from its releases page: in Chrome, unzip the chrome zip and load it unpacked (chrome://extensions → Developer mode → Load unpacked). Safari isn't available yet (it will ship inside the ContextMint app, which has no public download), so use Chrome for now. ContextMint Bridge is the fetchproxy browser extension under its new name, from the same maintainer — fetchproxy's own README (https://github.com/chrischall/fetchproxy#extension) points to it. Its source is public at https://github.com/nullnet-app/contextmint-bridge: build it yourself, or check a release zip against the .sha256 file published beside it (shasum -a 256 -c contextmint-bridge-chrome-<version>.zip.sha256). Keep an exploretock.com tab open. The first tool call prints a one-time pair code to approve in the ContextMint Bridge popup — run tock_healthcheck to trigger it. Discovery works signed-out; the account tools need you signed in to exploretock.com.

Related MCP server: Restaurant Reservation MCP Server

Environment

No environment variables are required. These optional knobs mirror the .mcpb manifest's settings:

Variable

Default

Purpose

TOCK_WS_PORT

37149

Concentrator port for the fetchproxy browser bridge. Every fetchproxy MCP on one machine shares the concentrator, so move it for all of them or none (mainly for local testing, or a hosted registration's bridge port).

FETCHPROXY_WS_HOST

127.0.0.1

Bridge bind interface, a literal IP only (anything else is ignored). Keep on loopback; it exists for a hosted child in its own network namespace.

FETCHPROXY_IDENTITY_DIR

~/.fetchproxy/identity/

Where the bridge's long-term identity keypair is stored, an absolute path only (anything else is ignored). For a host that runs a separate child per caller.

Tools

  • tock_list_metros — Tock cities/metros with business counts; filter by name/country.

  • tock_search_restaurants — venues in a metro slug (cuisine, price, neighborhood, slug).

  • tock_get_restaurant — venue details + its bookable experiences.

  • tock_get_availability — a venue's bookable calendar (experiences, prices, open dates/times).

  • tock_list_reservations / tock_get_profile — the signed-in user's purchases and profile.

  • tock_verify_reservation — after a booking attempt, re-query the account and return an explicit confirmed / cancelled / not_found / ambiguous verdict. A success screen is not proof; this is.

  • tock_healthcheck — bridge status + the one-time pair code.

Develop

npm install
npm run build     # tsc + esbuild bundle → dist/bundle.js
npm test          # vitest

Architecture and the reverse-engineered Tock surface are documented in docs/TOCK-API.md.

License

MIT

Available Tools

8 tools
tock_get_availabilityA
Read-only

Get a venue's bookable calendar: each experience (seating/menu) with its price, party sizes, cancellation policy, plus the dates and times the venue is open. Tock returns the full open-date/time set; pass a date to focus the summary. Reservations are prepaid tickets — this MCP does not book; open the venue on exploretock.com to reserve.

Inputs: slug (required), date, party_size.

tock_get_profileA
Read-only

Get the signed-in user's Tock account identity (name, email). Requires a browser tab signed in to exploretock.com via the ContextMint Bridge extension. Derived from your reservation records, so it needs at least one reservation on the account.

Inputs: view.

tock_get_restaurantA
Read-only

Get details for a Tock venue by slug: name, cuisine, price band, location, description, and its bookable experiences (with prices and party sizes). Slug comes from tock_search_restaurants (or a exploretock.com/{slug} URL).

Inputs: slug (required), view.

tock_healthcheckVerify the ContextMint Bridge connection end-to-endA
Read-onlyIdempotent

Round-trips a small public www.exploretock.com URL (/robots.txt) through ContextMint Bridge (your signed-in browser tab) and returns diagnostics: the bridge's role (host/peer/null), port, version, the extension link (linked / pair pending / not attached / never answered), the elapsed round-trip time, and a plain-English hint distinguishing 'bridge never came up' from 'extension not connected' from 'this browser can't serve a capability' from 'real www.exploretock.com-side problem'. Read-only, no auth required. Call this when a real tool fails and you want to know which hop broke.

Inputs: no named parameters.

tock_list_metrosA
Read-only

List Tock cities/metros (name, slug, business count, country/state). Use a metro slug with tock_search_restaurants. By default only metros with bookable venues are returned.

Inputs: limit, query, country, include_empty.

tock_list_reservationsA
Read-only

List the signed-in user's Tock reservations (upcoming, past, or canceled) with venue, date/time, party size, and experience. Pass view: "brief" for one line per reservation. Requires a browser tab signed in to exploretock.com via the ContextMint Bridge extension.

Inputs: view, limit, offset, status.

tock_search_restaurantsA
Read-only

List / search restaurants in a Tock metro. Pass a metro slug (from tock_list_metros, e.g. "chicago") and an optional text query. Returns venues with cuisine, price band, neighborhood, and their Tock slug (use it with tock_get_restaurant / tock_get_availability). Does NOT include bookable slots.

Inputs: metro (required), limit, query.

tock_verify_reservationA
Read-only

Verify that a Tock reservation actually exists, by re-querying the account's own reservation lists (upcoming, canceled and past) and returning an explicit verdict. Use this after ANY booking attempt — a success screen or screenshot is not proof that a booking landed. Returns verdict confirmed, cancelled (it existed and was voided), not_found, or ambiguous (the venue string matched more than one restaurant on that date — re-run with the exact slug). A not_found must be reported to the user as "attempted, unverified", never as a failure to book and never as a success. Requires a browser tab signed in to exploretock.com via the ContextMint Bridge extension.

Inputs: date (required), venue (required), partySize, bookedMinutesAgo.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool has a clearly distinct role: metro discovery, restaurant search, venue details, availability, reservation listing, identity, verification, and bridge diagnostics. The closest pair, tock_list_reservations and tock_verify_reservation, is well differentiated by the latter's explicit existence-verdict purpose.

    Naming Consistency4/5

    All names share the tock_ prefix and snake_case, with predictable verb_noun patterns like tock_get_restaurant and tock_search_restaurants. The main minor deviation is tock_healthcheck, which is noun-style rather than verb_noun.

    Tool Count5/5

    Eight tools is well-scoped for a read-only Tock lookup and verification server. Each tool serves a distinct step in the workflow, from discovery to reservation verification and diagnostics.

    Completeness4/5

    The surface covers metro search, restaurant discovery, venue details, availability, reservation listing, profile, verification, and bridge health. The notable gap is the absence of booking, but that is explicitly out of scope and users are directed to exploretock.com; minor detail-level reservation retrieval could also be richer.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    • OpenTable MCP server for ChatGPT, Claude and any AI agent: search restaurants with open tables, check availability, book a reservation, modify a reservation, cancel a reservation, list your reservations, read the reservation book and add guest notes and tags in your own OpenTable account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to OpenTable yourself; Cotlet does not store your password and you need no OpenTable API key. About the official OpenTable API: OpenTable has APIs only for approved partners (checked 27 Oct 2026). Booking, Sync, CRM, Directory and Reviews APIs need an application through the OpenTable partner program, and they work per restaurant, not on a diner account. Setup and FAQ: https://cotlet.dev/integrations/opentable-api-mcp-server

    • Find Resy restaurants and request reservations through Scout; the user approves every booking.

      https://dinewithscout.com/mcp
    • Resy MCP server for ChatGPT, Claude and any AI agent: search restaurants, check availability, book a reservation, list reservations, change a reservation, cancel a reservation, set a Notify alert and remove a Notify alert in your own Resy account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Resy yourself; Cotlet does not store your password and you need no Resy API key. About the official Resy API: Resy has no public API (checked 27 Oct 2026). Its official Resy app runs only inside Claude and ChatGPT: in Claude it shows live availability and sends you to Resy to book, in ChatGPT it can also book a table. Setup and FAQ: https://cotlet.dev/integrations/resy-api-mcp-server

      https://cotlet.dev/mcp/v1/resy
    • Find local shops, read live menus and free times, and order or book on the user's behalf.

      https://openajan.com/mcp

    Related MCP Servers