tock-mcp
A read-only MCP server for Tock (exploretock.com) that relays restaurant discovery, availability, and your own account data through your signed-in browser tab via the ContextMint Bridge extension — it never books anything.
List metros/cities (
tock_list_metros) — Tock cities with business counts; filter by name, country, or include empty ones.Search venues in a metro (
tock_search_restaurants) — restaurants with cuisine, price band, neighborhood, and Tock slug (no bookable slots).Get venue details (
tock_get_restaurant) — name, cuisine, price band, location, description, and bookable experiences with prices/party sizes.Get a venue's calendar (
tock_get_availability) — experiences, prices, party sizes, cancellation policy, and open dates/times; optionally focus on a date or party size.List your reservations (
tock_list_reservations) — upcoming, past, or canceled purchases for the signed-in account.Get your profile (
tock_get_profile) — account name/email (derived from reservation records, so requires at least one reservation).Verify a booking (
tock_verify_reservation) — re-queries the account and returnsconfirmed/cancelled/not_found/ambiguousfor a venue + date.Check bridge health (
tock_healthcheck) — round-trips a public Tock URL to diagnose which hop (bridge, extension, or Tock) is broken, and surfaces the one-time pair code.
Everything is marked read-only; reservations are prepaid tickets and must be completed on exploretock.com itself. Account tools need you signed in, while discovery works signed-out.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@tock-mcp search for Italian restaurants in New York City"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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_STATEstore) 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 |
|
| 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). |
|
| 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. |
|
| 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 explicitconfirmed/cancelled/not_found/ambiguousverdict. 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 # vitestArchitecture and the reverse-engineered Tock surface are documented in docs/TOCK-API.md.
License
MIT
Available Tools
8 toolstock_get_availabilityARead-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_profileARead-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_restaurantARead-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-endARead-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_metrosARead-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_reservationsARead-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_restaurantsARead-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_reservationARead-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
Scored across 8 tools
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.
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.
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.
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
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.
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
Find local shops, read live menus and free times, and order or book on the user's behalf.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables restaurant reservation management through SevenRooms API, allowing users to create reservations and query available time slots with guest details and party size information.-
- AlicenseBqualityDmaintenanceEnables users to search, check availability, and book restaurant reservations across Resy and OpenTable platforms. It supports direct booking for Resy and includes an automated reservation 'sniper' for securing high-demand slots the moment they become available.124MIT
- AlicenseAqualityDmaintenanceEnables AI agents to search restaurants, check availability, and book reservations on OpenTable, including managing booking history and handling multi-factor authentication.9260 npmMIT
- AlicenseAqualityDmaintenanceEnables AI agents to search restaurants, check availability, and book reservations on OpenTable, with persistent sessions and MFA handling.9260 npm1MIT