Skip to main content
Glama
thumbtack-mcp

thumbtack-mcp

by chrischall

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

thumbtack_search_pros

Search pros by trade + US ZIP. Returns up to 10 with rating, review count, lifetime hires, mean response time, profile URL.

thumbtack_resolve_service

Canonicalise a loose service name (plumbing → plumbers) by asking Thumbtack.

thumbtack_get_pro

A pro's profile: name, description, location, aggregate rating, credentials, section inventory.

thumbtack_get_pro_reviews

Reviews on a pro's profile — stars, author, date, text.

thumbtack_graphql

Escape hatch for arbitrary read-only GraphQL. Mutations refused.

thumbtack_healthcheck

Probes 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

npm install
npm run build
npm test            # unit + server-boot smoke tests
npm run test:coverage

Coverage is enforced at 100%.

License

MIT

Available Tools

6 tools
thumbtack_get_proA
Read-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_reviewsA
Read-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_graphqlA
Read-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_healthcheckA
Read-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_serviceA
Read-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_prosA
Read-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

    A4.2/5.0

    Scored across 6 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityActive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      MCP 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.
      22
      76 npm
      6
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Public 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
    • A
      license
      A
      quality
      C
      maintenance
      MCP 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.
      6
      121 npm
      1
      MIT