Tock Mcp

io.github.chrischallPublished by GitHub account chrischallv1.2.1Updated Nov 5, 2026

Tock (exploretock.com): discover restaurants, search a city, get venue details and availability.

Overview

AI-generated overview

Read-only MCP server for Tock (exploretock.com) that lets an assistant browse restaurant metros, search venues, and check availability through your signed-in…

What you can do
  • List Tock cities/metros with business counts and filter them by name or country
  • Search restaurants in a metro by text query, returning cuisine, price band, neighborhood and venue slug
  • Fetch venue details, including bookable experiences with prices and party sizes
  • Read a venue's availability calendar: experiences, cancellation policy, open dates and times
  • List the signed-in user's reservations and account profile, and verify whether a reservation actually exists
  • Run a bridge healthcheck that reports extension status and a one-time pair code
When to use it
Useful when you want an assistant to research restaurants and check bookable dates and times on Tock, or to confirm that a Tock reservation on your account really landed. Discovery works signed out; account tools need a signed-in exploretock.com tab.
Requirements
Runs locally via npx (Node.js). Needs the ContextMint Bridge browser extension loaded in Chrome and an open exploretock.com tab; the first call prints a one-time pair code to approve in the extension popup. Sign-in on exploretock.com is required for reservation and profile tools. No environment variables are required; TOCK_WS_PORT, FETCHPROXY_WS_HOST and FETCHPROXY_IDENTITY_DIR are optional.
Before you install
It relays requests through your signed-in browser session, so the assistant acts with your Tock account's access; keep the bridge on loopback and only pair with an extension you trust. It is read-only and does not book, since Tock reservations are prepaid tickets. It scrapes server-rendered pages because Tock has no public API and sits behind a Cloudflare challenge, so it may break; the README says to use it at your own discretion.

Installation

In SourceWeft

  1. Open Tock Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

json
// .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.

Environment

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

VariableDefaultPurpose
TOCK_WS_PORT37149Concentrator 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_HOST127.0.0.1Bridge 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

bash
npm installnpm run build     # tsc + esbuild bundle → dist/bundle.jsnpm test          # vitest

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

License

MIT

Source: README.md at commit b1bfe60

Tools

8

tock_list_metros

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.

Parameterslimitquerycountryinclude_empty

tock_search_restaurants

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.

Parameterslimitmetrorequiredquery

tock_get_restaurant

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).

Parametersslugrequiredview

tock_get_availability

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.

Parametersdateslugrequiredparty_size

tock_list_reservations

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.

Parametersviewlimitoffsetstatus

tock_get_profile

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.

Parametersview

tock_verify_reservation

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.

ParametersdaterequiredvenuerequiredpartySizebookedMinutesAgo

tock_healthcheck

Verify the ContextMint Bridge connection end-to-end

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.

Takes no parameters.

Version history

12
  1. v1.2.1LatestNov 4, 2026
  2. v1.1.9Oct 16, 2026
  3. v1.1.8Oct 10, 2026
  4. v1.1.7Oct 7, 2026
  5. v1.1.6Oct 5, 2026
  6. v1.1.5Oct 3, 2026
  7. v1.1.3Sep 25, 2026
  8. v1.1.2Sep 23, 2026
  9. v1.1.1Sep 23, 2026
  10. v1.1.0Sep 20, 2026
  11. v1.0.0Sep 19, 2026
  12. v0.5.4Sep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts