Tock Mcp

io.github.chrischall由 GitHub 账号 chrischall 发布v1.2.1更新于 Nov 5, 2026

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

已验证STDIO仅桌面位置与生活浏览器自动化

概览

AI 生成的概览

面向 Tock(exploretock.com)的只读 MCP 服务器,让助手通过你已登录的浏览器标签页浏览城市、搜索餐厅并查看可订时段。

可以做什么
  • 列出 Tock 城市/都会区及其商户数量,并按名称或国家筛选
  • 按关键词搜索某个都会区的餐厅,返回菜系、价位、街区与场所 slug
  • 获取场所详情,包括可预订体验、价格与人数范围
  • 读取场所的可订日历:体验、取消政策、开放日期与时间
  • 列出已登录用户的预订与账户资料,并核验某笔预订是否真实存在
  • 执行桥接健康检查,返回扩展状态与一次性配对码
适用场景
适合让助手调研餐厅、查询 Tock 上可订的日期与时段,或在订位后确认账户中是否真的产生了该预订。浏览功能无需登录;账户相关工具需要已登录 exploretock.com 的标签页。
运行要求
通过 npx 在本机运行(需要 Node.js)。需要在 Chrome 中加载 ContextMint Bridge 浏览器扩展,并保持一个 exploretock.com 标签页打开;首次调用会显示一次性配对码,需在扩展弹窗中确认。预订与资料工具需要登录 exploretock.com。无需环境变量;TOCK_WS_PORT、FETCHPROXY_WS_HOST、FETCHPROXY_IDENTITY_DIR 为可选项。
安装前请注意
请求经由你已登录的浏览器会话转发,助手将以你 Tock 账户的权限操作;请让桥接保持在本机回环地址,并只与可信的扩展配对。它是只读的,不会代为订位,因为 Tock 的预订是预付票券。由于 Tock 没有公开 API 且受 Cloudflare 挑战保护,它通过解析服务端渲染页面取数,可能随时失效;README 提示需自行斟酌使用。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Tock Mcp,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

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

来源:README.md,提交 b1bfe60

工具

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.

输入参数limitquerycountryinclude_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.

输入参数limitmetro必填query

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

输入参数slug必填view

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.

输入参数dateslug必填party_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.

输入参数viewlimitoffsetstatus

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.

输入参数view

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.

输入参数date必填venue必填partySizebookedMinutesAgo

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.

无需输入参数。

版本历史

12
  1. v1.2.1最新Nov 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

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分