Thumbtack MCP Server
Community MCP connector for Thumbtack's home services marketplace. Search local pros, request quotes, and hire providers via Playwright browser automation.
The Thumbtack MCP server is a community-built connector published by Strider Labs (@striderlabs/mcp-thumbtack) that lets AI agents interact with Thumbtack, the marketplace for finding and hiring local professionals (plumbers, electricians, cleaners, photographers, movers, and similar service providers). It is not an official Thumbtack product.
Under the hood the server is a TypeScript application built on the @modelcontextprotocol/sdk and Playwright. Because Thumbtack does not publish a public consumer API, the connector drives a headless browser session to search the Thumbtack site, retrieve provider details, request quotes, view incoming responses, and initiate hire flows. A managed browser instance is created at startup and cleanly closed on SIGINT, SIGTERM, or uncaught exception.
The server exposes six tools: thumbtack_search_services, thumbtack_get_provider, thumbtack_request_quote, thumbtack_view_quotes, thumbtack_hire_provider, and thumbtack_get_projects. Together these cover the typical consumer journey from discovering pros to managing active jobs. Note that the README is currently missing from the GitHub repo, so documentation has to be inferred from the source tree and server.json manifest.
Tools
| Tool | Description |
|---|---|
thumbtack_search_services |
Search Thumbtack for local service providers by category and location. |
thumbtack_get_provider |
Retrieve detailed information about a specific Thumbtack pro. |
thumbtack_request_quote |
Submit a quote request to a provider with project details and contact info. |
thumbtack_view_quotes |
List quotes returned by providers, optionally filtered by status. |
thumbtack_hire_provider |
Hire a provider by accepting a specific quote. |
thumbtack_get_projects |
List the user's Thumbtack projects, optionally filtered by status. |
Prerequisites
- Node.js 20+
- A Thumbtack consumer account (the connector drives a logged-in browser session via Playwright)
- Playwright browser binaries installed locally
Install
The package is published as @striderlabs/mcp-thumbtack and exposes a mcp-thumbtack CLI entry point.
npm install -g @striderlabs/mcp-thumbtack
npx playwright install chromium
Claude Desktop / Cursor config
Add the server to your MCP client config (for example claude_desktop_config.json):
{
"mcpServers": {
"thumbtack": {
"command": "npx",
"args": ["-y", "@striderlabs/mcp-thumbtack"]
}
}
}
Build from source
git clone https://github.com/markswendsen-code/mcp-thumbtack.git
cd mcp-thumbtack
npm install
npm run build
npm start
Notes
- The repository does not currently ship a README, so configuration details (such as how Thumbtack credentials are supplied to the Playwright session) must be derived from the source under
src/. - The server registers SIGINT/SIGTERM handlers to close the browser cleanly on shutdown.
- Find a vetted local pro for a home project ("search for licensed electricians in 94110 available next week") and compare ratings before reaching out.
- Automate quote requests across multiple providers for the same job, then aggregate responses with
thumbtack_view_quotes. - Track the state of ongoing home projects through
thumbtack_get_projects, filtered by pending, active, or completed status. - Pull provider details (business name, reviews, hires) into an internal sourcing workflow or spreadsheet via
thumbtack_get_provider. - Close the loop on a vetted quote by calling
thumbtack_hire_providerdirectly from an agent once the user approves.
- "Find top-rated house cleaners in 78704 available this Saturday and show me their ratings and number of hires."
- "Request quotes from three plumbers near zip 02139 to fix a leaking kitchen faucet. Use my saved contact info."
- "Show me all pending quotes I've received this week."
- "Get full details for the Thumbtack provider at this URL: https://www.thumbtack.com/profile/services/..."
- "List all my active Thumbtack projects and tell me which ones are still waiting on a response."
- Covers the full Thumbtack consumer flow: discovery, quoting, viewing responses, and hiring.
- Built on the official
@modelcontextprotocol/sdkwith a clean tool schema and graceful shutdown handling. - Browser-automation approach (Playwright) works without needing a public Thumbtack API.
- Community-maintained and not affiliated with or endorsed by Thumbtack. Breakage is likely whenever Thumbtack changes its site.
- Repository ships no README and no documented authentication path, so getting a logged-in session set up requires reading the source.
- Playwright-driven scraping is slower and more brittle than a real API, and may violate Thumbtack's terms of service depending on use.
- Apify's hosted Thumbtack Service Scraper MCP for read-only provider data via the Apify Actor platform.
- Apify's Thumbtack Seller Details Scraper MCP for bulk pro/business detail extraction.
- A generic Playwright or Browserbase MCP server pointed at Thumbtack if you need fully custom flows.