Log inSubmit server
Thumbtack MCP logo

Thumbtack MCP

Read-only MCP tools for searching Thumbtack pros and reading profiles, ratings, credentials, and reviews by US ZIP code.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Thumbtack MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "thumbtack-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@chrischall/thumbtack-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 6 tools correctly (Today).

Overview

The thumbtack-mcp MCP server exposes anonymous, read-only access to Thumbtack search and profile data. It searches local service professionals by trade and US ZIP code, resolves service names, reads profiles and reviews, and provides a read-only GraphQL escape hatch. Use it for local-pro research and structured lookups when account actions, messaging, quotes, or other write operations are not required. It runs without a Thumbtack account, API key, or browser extension.

Use cases

  • Search local professionals by trade and US ZIP code
  • Compare ratings, review counts, hires, and response times
  • Read a professional's profile and credentials
  • Extract reviews from a Thumbtack profile
  • Check whether Thumbtack response formats remain usable

Key features

  • Anonymous, read-only Thumbtack access
  • Professional search by trade and US ZIP
  • Canonical service-name resolution
  • Profile and review extraction
  • Read-only GraphQL queries
  • Page and GraphQL health checks

Tools6

What Thumbtack MCP lets your agent do. Expand a tool for its parameters.

Verified live~1.2k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

10/10 checks healthy over the last 51d

What it can do

From the 6 tools this server returned when we ran it; 6 declare their own safety hints.

Handles credentials · 1Makes network requests · 6Read-only tools · 6
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age83 days
Maintainers1

Observed 2026-11-02 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 10d ago via OSV.dev · @chrischall/thumbtack-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads1.3kPackage downloads in the last 30 days.
Last commit7d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed6Callable tools this server registers over MCP.

How Thumbtack MCP works

What thumbtack-mcp MCP server does

The thumbtack-mcp MCP server connects MCP clients to public Thumbtack consumer pages and Thumbtack's anonymous GraphQL endpoint. Its primary use is local service-pro research: an agent can search by trade and US ZIP code, inspect returned professionals, and read profile details, credentials, ratings, and reviews.

Search results contain up to 10 pros and can include each professional's rating, review count, lifetime hires, average response time, and profile URL. A separate service-resolution tool converts informal service labels into Thumbtack's canonical form, such as resolving plumbing to plumbers.

This belongs in the Search & Data Extraction category. It is intended for reading publicly available consumer-facing data rather than managing a Thumbtack account or contacting providers.

How it works

The server reads three verified Thumbtack surfaces. Search pages provide result data embedded in __NEXT_DATA__. Profile pages expose information through window.__APOLLO_STATE__ and schema.org JSON-LD. The GraphQL endpoint at app.thumbtack.com/graphql accepts anonymous read queries, while introspection is disabled.

The implementation accounts for response details that matter when consuming the data. A GraphQL request may return HTTP 200 while also carrying an errors[] object, so the response body must be checked rather than relying on status alone. Profile JSON-LD uses trade-specific types, such as Plumber, instead of always using LocalBusiness.

Setup and configuration

Add the server to an MCP client's configuration with the npx command and the @chrischall/thumbtack-mcp package. The provided configuration uses -y so the package can be run without a separate global installation.

No environment variables are required. The server needs no Thumbtack login, API key, or browser extension because it uses anonymous consumer pages and GraphQL requests.

Tools and capabilities

The thumbtack-mcp MCP server provides these tools:

  • thumbtack_search_pros searches for professionals by trade and US ZIP code.
  • thumbtack_resolve_service maps a loose service name to Thumbtack's canonical service name.
  • thumbtack_get_pro returns a professional's name, description, location, aggregate rating, credentials, and section inventory.
  • thumbtack_get_pro_reviews returns review stars, authors, dates, and text.
  • thumbtack_graphql runs arbitrary read-only GraphQL queries; mutations are rejected.
  • thumbtack_healthcheck checks the page and GraphQL surfaces independently and reports whether their response shapes remain recognized.

Read tools support view values of compact and full, with compact as the default. Search uses a defined field projection in compact mode. Profile, review, and GraphQL responses omit image URLs in compact mode. Full mode returns the upstream records, which may contain substantial tracking metadata. The service-resolution and healthcheck tools do not accept view.

Limitations and notes

The thumbtack-mcp MCP server is unofficial and may break if Thumbtack changes its pages or endpoint behavior. The repository notes that use may conflict with Thumbtack's terms of service, so evaluate that risk before deployment.

It cannot access account-specific projects, messages, or quotes. Thumbtack's consumer write paths require a login protected by reCAPTCHA, so server-side account login and write actions are not supported. The documented Partner Platform API is also outside this server's scope because it requires partner credentials.

A shell-only skill in the repository covers the same surface with curl and jq for one-off lookups and scripts without running an MCP process.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Thumbtack MCP

thumbtack-mcp is an MCP server that connects AI clients to Thumbtack's anonymous consumer pages and GraphQL endpoint. Its main tools search local professionals by trade and US ZIP code, resolve service names, retrieve pro profiles and reviews, run read-only GraphQL queries, and check whether Thumbtack response formats remain compatible.

Install it by adding an MCP configuration that runs `npx -y @chrischall/thumbtack-mcp`. The repository provides a `.mcp.json` example using the server name `thumbtack`. No global package installation or additional configuration is required.

No, thumbtack-mcp requires no API key, account, or browser extension. It reads Thumbtack's server-rendered consumer pages and anonymous GraphQL endpoint. No environment variables are required to run the server.

No, thumbtack-mcp is read-only and cannot manage projects, messages, quotes, or other account actions. Thumbtack's write paths are behind a reCAPTCHA-gated login that this server-side client cannot pass.

Pass `view: "full"` to the search, profile, review, or GraphQL read tools. Compact mode is the default; it projects search fields and removes image URLs from other supported responses. The full records may include substantial tracking metadata.

Related MCP servers

All in Search & Data Extraction All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewThumbtack MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/thumbtack-mcp?style=directory)](https://allmcps.com/mcp/thumbtack-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/thumbtack-mcp"><img src="https://allmcps.com/api/badge/thumbtack-mcp?style=directory" alt="Thumbtack MCP on AllMCPs" /></a>