thumbtack-mcp
An anonymous, read-only MCP server for searching and reading Thumbtack local service pros.
Search pros by trade/service and US ZIP, returning up to 10 with rating, review count, lifetime hires, mean response time, and profile URL.
Resolve loose service names to canonical Thumbtack slugs (e.g. "plumbing" → "plumbers").
Fetch a pro's profile: name, description, location, aggregate rating, credentials, and section inventory.
Fetch reviews from a pro's profile: stars, author, date, text, with optional limit.
Run arbitrary read-only GraphQL queries against Thumbtack's anonymous endpoint; mutations are refused.
Check health/reachability of the HTML page and GraphQL surfaces, reporting probe kind/status.
Use compact (default) or full view on read tools to control response detail.
Provides tools for searching local service pros and reading their profiles, ratings, reviews, and credentials on Thumbtack.
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., "@thumbtack-mcp find plumbers in 94110"
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.
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
// .mcp.json
{ "mcpServers": { "thumbtack": { "command": "npx", "args": ["-y", "@chrischall/thumbtack-mcp"] } } }No configuration — there are no environment variables.
Related MCP server: valet-parking-directory
Tools
Tool | What it does |
| Search pros by trade + US ZIP. Returns up to 10 with rating, review count, lifetime hires, mean response time, profile URL. |
| Canonicalise a loose service name ( |
| A pro's profile: name, description, location, aggregate rating, credentials, section inventory. |
| Reviews on a pro's profile — stars, author, date, text. |
| Escape hatch for arbitrary read-only GraphQL. Mutations refused. |
| Probes the page and GraphQL surfaces separately and reports the response shape still matches; each probe names a |
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:
Search pages — results embedded in
__NEXT_DATA__.Profile pages —
window.__APOLLO_STATE__(a bare JS assignment, so it needs balanced-brace extraction) plus schema.org JSON-LD.GraphQL (
app.thumbtack.com/graphql) — accepts ad-hoc anonymous queries; introspection is disabled.
Two things that bite anyone reading these pages:
JSON-LD
@typeis the trade-specific subtype, notLocalBusiness— 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
npm install
npm run build
npm test # unit + server-boot smoke tests
npm run test:coverageCoverage is enforced at 100%.
License
MIT
Available Tools
6 toolsthumbtack_get_proARead-only
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.
Inputs: url (required), view.
thumbtack_get_pro_reviewsARead-only
Read the reviews embedded on a Thumbtack pro's profile page (star rating, author, date, text). Takes a profile URL from thumbtack_search_pros.
Inputs: url (required), view, limit.
thumbtack_graphqlARead-only
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.
Inputs: query (required), view, variables.
thumbtack_healthcheckARead-only
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).
Inputs: no named parameters.
thumbtack_resolve_serviceARead-only
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.
Inputs: service (required), zip.
thumbtack_search_prosARead-only
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.
Inputs: zip (required), service (required), view, limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a distinct step in the browse flow: slug resolution, search, profile read, reviews read, plus a healthcheck. The only soft overlap is thumbtack_graphql, which is a generic escape hatch that could duplicate other tools' work, but it is clearly labeled as a raw query fallback so misselection risk is low.
Consistent snake_case with a uniform thumbtack_ prefix throughout. resolve/search/get follow a clear verb_noun pattern; graphql and healthcheck omit a verb, but their conventional naming is readable and predictable rather than chaotic.
Six tools is a tight, well-scoped set for an anonymous read-only browsing server, and every tool earns its place (resolve, search, profile, reviews, raw fallback, healthcheck). No redundant or filler tools.
The discovery lifecycle is well covered: resolve a service, search pros, read a profile, read its reviews, plus an escape hatch for anything missed. Minor gaps like listing categories or paging results exist, but the GraphQL tool lets agents work around them.
Maintenance
Related MCP Connectors
ProxyLink MCP server for finding and booking home service professionals
Search 33,000+ MCP servers by job, see safety grades and reviews, and call them from one endpoint.
MCP server for Muovi, Argentina's trust-first local services marketplace: find pros, draft tasks.
Federated commerce search across independent WooCommerce merchants. Keyless, read-only MCP server.
Related MCP Servers
- AlicenseBqualityDmaintenanceMCP server for searching marketplaces (TCGPlayer, Reverb, Thumbtack), verifying professional licenses (contractor, nurse), and looking up PSA card grading data. Returns real-time pricing, listings, and verification results.2276 npm6MIT
- AlicenseNot gradedqualityCmaintenancePublic read-only MCP server backed by GetValetParking.com directory of 789 US valet parking operators across 31,186 cities. Discover valet operators by coordinates or city slug, filter by 9 service types, and fetch full operator profiles. No auth required.MIT
- AlicenseAqualityDmaintenanceUnofficial, read-only MCP server for Fandango showtimes and seat availability, reverse-engineered from observed web traffic.462MIT
- AlicenseAqualityCmaintenanceMCP server for Muovi, Argentina's local services marketplace. Enables discovery of verified service professionals, browsing services and cities, reading reviews, and generating deep-links for task creation.6121 npm1MIT