Thumbtack Mcp

io.github.chrischall由 GitHub 帳號 chrischall 發布v1.2.0更新於 Nov 5, 2026

Unofficial Thumbtack MCP — search local service pros, read profiles, ratings and reviews

概覽

AI 產生的概覽

非官方、唯讀的 MCP 伺服器,讓助理依工種與美國郵遞區號在 Thumbtack 搜尋在地服務業者,並讀取其檔案、評分與評論。

可以做什麼
  • 依工種與美國郵遞區號搜尋業者,回傳最多 10 筆結果,含評分、評論數、累計成交與回應時間
  • 把籠統的服務名稱解析為 Thumbtack 的標準 slug
  • 讀取業者檔案:簡介、地點、整體評分、資格認證與區塊清單
  • 讀取業者檔案頁上內嵌的評論
  • 對 Thumbtack 匿名 GraphQL 端點執行任意唯讀查詢
  • 探測 Thumbtack 的頁面與 GraphQL 介面是否可達、回傳結構是否仍符合預期
適用情境
適合讓助理在美國尋找並比較在地服務業者(如水電、電工等),彙整其評分、評論與資格,而不必開啟瀏覽器。也可在依賴此擷取介面前先確認是否仍可用。
執行需求
透過 npx 從 npm 套件 @chrischall/thumbtack-mcp 在本機執行,需要 Node.js 以及連線 Thumbtack 的網路。不需帳號、API 金鑰、環境變數或標頭。
安裝前請注意
它讀取 Thumbtack 的伺服器端渲染頁面與匿名 GraphQL 端點,README 指出這可能失效或違反其服務條款。擷取結果可能結構改變或被 CDN/WAF 阻擋。GraphQL 工具可執行任意唯讀查詢,寫入操作會被拒絕。它無法存取你自己的 Thumbtack 帳號、專案、訊息或報價。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Thumbtack Mcp,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

thumbtack-mcp

Unofficial Thumbtack MCP server — search local service pros, and read their profiles, ratings, reviews and credentials.

Read-only and anonymous. Thumbtack's consumer pages and its GraphQL endpoint answer without a login, so this server needs no account, no API key and no browser extension. It also cannot write: Thumbtack's write paths sit behind a reCAPTCHA-gated login that no server-side client can pass.

Thumbtack has no public consumer API. This server reads its server-rendered pages and anonymous GraphQL endpoint, and may break or violate their ToS. Developed and maintained by AI (Claude). Use at your own discretion.

Install

jsonc
// .mcp.json{ "mcpServers": { "thumbtack": { "command": "npx", "args": ["-y", "@chrischall/thumbtack-mcp"] } } }

No configuration — there are no environment variables.

Tools

ToolWhat it does
thumbtack_search_prosSearch pros by trade + US ZIP. Returns up to 10 with rating, review count, lifetime hires, mean response time, profile URL.
thumbtack_resolve_serviceCanonicalise a loose service name (plumbing → plumbers) by asking Thumbtack.
thumbtack_get_proA pro's profile: name, description, location, aggregate rating, credentials, section inventory.
thumbtack_get_pro_reviewsReviews on a pro's profile — stars, author, date, text.
thumbtack_graphqlEscape hatch for arbitrary read-only GraphQL. Mutations refused.
thumbtack_healthcheckProbes the page and GraphQL surfaces separately and reports the response shape still matches; each probe names a kind, and a CDN/WAF refusal page is edge_blocked.

Every read tool takes view: "compact" | "full", and compact is the default. On thumbtack_search_pros that is a hand-written field projection; on thumbtack_get_pro, thumbtack_get_pro_reviews and thumbtack_graphql it strips image URLs, which needs no knowledge of the payload's shape. Pass view: "full" for the untouched upstream records — they are large and mostly tracking metadata, which is why the slim shape is what you get without asking.

thumbtack_resolve_service and thumbtack_healthcheck take no view: both already answer with a handful of scalar fields, and a rung that cannot change anything is worse than no parameter.

Shell-only alternative

skills/thumbtack/ is a self-contained skill covering the same surface with plain curl + jq — no server process. Use it for one-shot lookups and scripts.

How it works

Three verified surfaces, all pinned in docs/THUMBTACK-API.md:

  1. Search pages — results embedded in __NEXT_DATA__.
  2. Profile pages — window.__APOLLO_STATE__ (a bare JS assignment, so it needs balanced-brace extraction) plus schema.org JSON-LD.
  3. GraphQL (app.thumbtack.com/graphql) — accepts ad-hoc anonymous queries; introspection is disabled.

Two things that bite anyone reading these pages:

  • JSON-LD @type is the trade-specific subtype, not LocalBusiness — a plumber's node is "@type":"Plumber". Match by shape, not by type name.
  • GraphQL returns HTTP 200 with an errors[] body. Status alone is never sufficient.

Not covered

  • Your own Thumbtack account (projects, messages, quotes) — the login is reCAPTCHA-gated, so there is no server-side password login.
  • The Partner Platform API (developers.thumbtack.com) — real and documented, but gated behind partner credentials ("Request Access"). It is a seller surface, not a consumer one.

Development

sh
npm installnpm run buildnpm test            # unit + server-boot smoke testsnpm run test:coverage

Coverage is enforced at 100%.

License

MIT

來源:README.md,提交 6406998

工具

6

thumbtack_search_pros

Search pros

Search Thumbtack for local service pros by trade and US ZIP code. Returns up to 10 ranked pros with rating, review count, lifetime hires, mean response time and profile URL. Anonymous — no account needed.

輸入參數zip必填viewlimitservice必填

thumbtack_resolve_service

Resolve service slug

Resolve a loose service name to the canonical Thumbtack slug by asking Thumbtack (it canonicalises via redirect, e.g. "plumbing" -> "plumbers"). Use before assuming a slug is right.

輸入參數zipservice必填

thumbtack_get_pro

Get pro profile

Read a Thumbtack pro's profile: name, description, location, aggregate rating, plus credentials (background check, licences) and the section inventory. Takes a profile URL from thumbtack_search_pros.

輸入參數url必填view

thumbtack_get_pro_reviews

Get pro reviews

Read the reviews embedded on a Thumbtack pro's profile page (star rating, author, date, text). Takes a profile URL from thumbtack_search_pros.

輸入參數url必填viewlimit

thumbtack_graphql

Raw GraphQL query

Escape hatch: issue an arbitrary read-only query against Thumbtack's anonymous GraphQL endpoint. Introspection is disabled upstream, so field names must come from a page's Apollo state. Mutations are refused.

輸入參數viewquery必填variables

thumbtack_healthcheck

Healthcheck

Check that Thumbtack's anonymous surface is reachable and still has the response shape this server expects. Reports the server version, the HTML page probe and the GraphQL probe separately, each with a `kind` (ok, edge_blocked, http, transport, timeout, rate_limited, shape_changed, unknown).

無需輸入參數。

版本歷史

12
  1. v1.2.0最新Nov 4, 2026
  2. v1.1.8Oct 16, 2026
  3. v1.1.7Oct 10, 2026
  4. v1.1.6Oct 7, 2026
  5. v1.1.5Oct 5, 2026
  6. v1.1.4Oct 3, 2026
  7. v1.1.3Sep 25, 2026
  8. v1.1.2Sep 23, 2026
  9. v1.1.1Sep 21, 2026
  10. v1.1.0Sep 20, 2026
  11. v1.0.0Sep 19, 2026
  12. v0.2.1Sep 16, 2026

評分

已滿足適用檢查項的 80%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。