Thumbtack MCP Server
Leads, messages, quotes and reviews for your Thumbtack pro profile.
Hosted MCP Server
npx add-mcp 'https://cotlet.dev/mcp/v1/thumbtack'Installs into Claude Code, Codex, Cursor and more
Documentation
Cotlet · Integrations · How it works · Security · For developers · For automation agencies · Blog · API docs · Help center · Changelog · Contact · Pricing · Sign up
Thumbtack API and MCP server: Let your AI agent answer your Thumbtack leads.
Thumbtack's official MCP server and its ChatGPT app serve homeowners hiring a pro, and its pro-side Partner API is open only to approved software partners (checked 27 Oct 2026). Cotlet runs 12 Thumbtack tools for the pro side, hosted, over MCP for agents and REST for scripts.
Leads, messages, quotes and reviews for your Thumbtack pro profile. Use it in ChatGPT, Claude or any AI agent over MCP, or in n8n, Make and scripts over REST.
- Free 7-day trial, no card
- Unofficial, not affiliated with Thumbtack
- Page: https://cotlet.dev/integrations/thumbtack-api-mcp-server
What can you automate in Thumbtack?
- Answer new leads with their details
- Follow up in Messages
- Quote Opportunities before they close
- Send an estimate from the thread
- Reply to new reviews
- Watch and set the weekly budget
Does Thumbtack have an MCP server or an API?
- mcp.thumbtack.com asks only for homeowner scopes: search pros, request forms, prices and orders. It cannot read your leads.
- Partner apps such as Front Desk ($60 a month), Housecall Pro and paid auto-responders answer new leads through the Partner API. Each sends its own fixed or AI message, not your agent's.
- No API reaches Opportunities, estimates or the weekly budget. Zapier and n8n have no Thumbtack app.
| What you need | Partner apps | Thumbtack MCP (homeowners) | Cotlet |
|---|---|---|---|
| Answer a new lead in Thumbtack | Yes, their message | No | Yes, after your OK |
| Read leads already in your account | Mostly new ones | No | Yes, any time |
| Quote Opportunities | No | No | Yes, under your fee limit |
| Send estimates | No | No | Yes, after your OK |
| Read or set the weekly budget | No | No | Yes |
| Works with your own AI agent | No, a fixed product | Claude and ChatGPT, homeowner side | Any MCP client |
Checked 27 Oct 2026. Sources: Thumbtack Partner Platform: Pro Negotiations, Supergood: Thumbtack API report card, Thumbtack in Claude (Business Wire), Thumbtack in ChatGPT, Thumbtack automation tools compared
How does Cotlet connect to Thumbtack?
- Sign in to Thumbtack. Use your own account in its Cotlet Cloud Browser.
- Choose MCP or REST. Connect your agent or create a Cotlet API key.
- Run your workflow. Ask your agent or send an HTTP request.
We never keep your Thumbtack password, and no reply, quote, estimate or budget change goes out until you approve it.
Connect Thumbtack to your agent or workflow
Use MCP with your AI agent, or HTTP requests in n8n, Make, Zapier and scripts. Follow the MCP setup below or jump to the REST guide.
- Enable Thumbtack for agents. Sign up, log in to your Thumbtack pro account in its Cloud Browser, then press Enable for agents.
- Add the Cotlet address. Save https://cotlet.dev/mcp/v1 in your agent as an MCP server or custom connector.
- Approve the connection. Chat apps open a Cotlet sign-in. Editors, n8n and scripts take an API key from the console.
Thumbtack shares https://cotlet.dev/mcp/v1 with every other app you enable on Cotlet. Turned Thumbtack on after you connected? Refresh the connector to load its tools.
Claude:
Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect
Claude Code:
claude mcp add --transport http cotlet-thumbtack \
https://cotlet.dev/mcp/v1 \
--header "Authorization: Bearer $COTLET_API_KEY"
ChatGPT:
Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth
Cursor:
// ~/.cursor/mcp.json
{
"mcpServers": {
"cotlet-thumbtack": {
"url": "https://cotlet.dev/mcp/v1",
"headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
}
}
}
Codex:
# ~/.codex/config.toml
[mcp_servers.cotlet-thumbtack]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"
n8n:
MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: thumbtack_read
Make, Zapier:
Make: MCP Client > Call a tool
Zapier: MCP Client by Zapier > Run Tool
Server URL: https://cotlet.dev/mcp/v1
Token: <your key>
Tool: thumbtack_write
How to use the Thumbtack REST API
Create your Cotlet API key
Create a Cotlet API key with access to Thumbtack and its read operations. Store it as COTLET_API_KEY in your environment or automation platform's credential store.
Connect Thumbtack in Cotlet and enable it for agents. Account access: Your own Thumbtack pro account.
Make your first Thumbtack API request
REST:
curl "https://cotlet.dev/api/v1/thumbtack/leads?limit=25" \
-H "Authorization: Bearer $COTLET_API_KEY"
Read leads and apply the operation limits
A successful REST call puts the tool output in result. This illustrative response excerpt omits call IDs, messages and credit details.
Illustrative response excerpt:
{
"status": "success",
"app": "thumbtack",
"tool": "list_leads",
"result": {
"leads": [
{
"lead_id": "519153480500518912",
"customer": "Dana R.",
"service": "Kitchen Remodel",
"location": "Austin, TX",
"created_at": "2026-10-11T07:42:00-05:00",
"replied": false
}
],
"next_cursor": "eyJvZmZzZXQiOjI1fQ"
}
}
Lists leads in your Thumbtack pro account, newest first, including older leads that a webhook would never have sent. Filter by creation date to see what came in since your last check.
Pass next_cursor back as cursor for the next page. Use get_lead for the customer's full answers.
limit: 1 to 100. Default: 25.
cursor: Next page cursor from the previous call.
Keep the same selection when continuing a list. Compare changed record values as well as identifiers when refreshing your destination.
Thumbtack workflows for agents and automations
| Tool | Connect through | Example workflow |
|---|---|---|
| n8n | HTTP Request | Full lead: the customer's answers to the job questions, location and timing. Use get_lead in your configured business report. |
| Make | HTTP > Make a request | Conversation with the customer on a lead, oldest first, with estimates you sent. Use list_messages in your configured business report. |
| Python or Node.js | REST API | Your weekly lead budget and what you have spent against it so far this week. Use get_budget in your configured business report. |
Send Authorization: Bearer <your Cotlet API key> in request headers. You configure the schedule, destination and record comparisons.
Cotlet reads Thumbtack; your workflow steps write to your chosen destination. These HTTP workflows do not require a native Cotlet connector or a prebuilt template.
Python and Node.js can use the same HTTP requests without an AI agent. Keep access keys in credentials, outside shared workflow exports.
The API and MCP reference lists operations and inputs. The REST API guide explains authentication, errors and approvals.
Thumbtack API endpoints and MCP tools
Leads and Messages
Leads from your Jobs page, old ones included, and the threads in Messages. Attachments go by URL.
- List leads (
list_leads, read): Leads from your Jobs page, newest first, with service, location and whether you replied. - Get lead (
get_lead, read): Full lead: the customer's answers to the job questions, location and timing. - List messages (
list_messages, read): Conversation with the customer on a lead, oldest first, with estimates you sent. - Reply to lead (
reply_to_lead, write, asks first): Send your first message to a lead. The conversation moves to your Messages. - Send message (
send_message, write, asks first): Send a message in an existing conversation with a customer.
Opportunities
Open leads with the fee shown upfront. The fee is charged to your card only if the customer answers, never from the weekly budget.
- List Opportunities (
list_opportunities, read): Open Opportunities you can quote, with the cost shown upfront and when each closes. - Reach out to Opportunity (
reach_out_to_opportunity, write, asks first): Message an Opportunity with an optional quote. You are charged only if the customer responds.
Estimates
Line items, discount and tax in the lead's conversation. A sent estimate cannot be cancelled, only replaced.
- Send estimate (
send_estimate, write, asks first): Send an estimate in the conversation with line items, discount and tax.
Reviews
Your public response is final: Thumbtack does not let you edit it.
- List reviews (
list_reviews, read): Reviews on your profile with rating, text, date and your response if any. - Reply to review (
reply_to_review, write, asks first): Post your public response under a review. Responses cannot be edited.
Weekly budget
Spend on leads so far this week and the limit that resets on Monday.
- Get budget (
get_budget, read): Your weekly lead budget and what you have spent against it so far this week. - Set weekly budget (
set_weekly_budget, write, asks first): Set the most you spend on leads in a week.
Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/thumbtack-api-mcp-server#tools
Who can see my Thumbtack session, and how do I revoke it?
- What we store. Your logged-in Thumbtack pro profile, AES-256-GCM, in Finland. No password.
- What your agent gets. The 12 Thumbtack tools. No cookie, no login.
- What the session sees. Your business: leads, customer answers and phone numbers, Messages, reviews, spend.
- What no tool touches. Payment method, lead prices, services, profile, password.
- If Thumbtack sends a code. An SMS or magic link goes to you. You enter it, we never do.
- How to cut access. Disable for agents, reset the browser or delete the key. The next call fails.
cotlet.dev rates A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results). We have no SOC 2 report or outside pentest yet.
Is it against Thumbtack's terms? Account safety
Using automated tools (including robots, spiders, or scrapers, etc.) to access the Platform without Thumbtack's prior written consent
The same terms make you answer for all activity on your account and let Thumbtack suspend it "with or without cause, with or without prior notice". Cotlet has no written consent from Thumbtack, so the risk sits with your account. Partner apps that answer leads hold that consent; we do not. We found no public case of a pro account closed for automation (checked 27 Oct 2026).
How we keep your account looking like you:
- Your own pro account, logged in by you
- One Cloud Browser with steady cookies and its own IP
- Replies, quotes, estimates and budget changes wait for your OK
- No tool changes lead prices, services or your payment method
- If Thumbtack objects, we pause the Thumbtack tools for everyone within 24 h
Thumbtack ranks pros on how fast and how well they answer. Keep replies specific to each job; the same pasted text to every lead reads like spam to customers too.
What happens when Thumbtack changes?
- 12 h between tests of the Thumbtack reads
- 24 h between tests of writes a customer would see
- $0 for a call to a Thumbtack tool paused for a fix
When Thumbtack moves the Opportunities tab or renames an estimate field, we change the tool and your agent keeps calling it by the same name. status.cotlet.dev checks the site, console and API every 3 minutes.
Approvals, undo and mistakes
- Lists Opportunities. By service, the soonest closing first.
- Applies your rules. Skips fees over your limit and towns you do not cover.
- Waits for your OK. Each quote shows up in your Cotlet console with its fee.
- Adds up the cost. Fees due if every customer answers, apart from the budget.
| Action | Undo |
|---|---|
| Reply to a lead or send a message | Not by any tool; the customer sees it at once |
| Reach out to an Opportunity | No; the fee is charged if the customer answers |
| Send an estimate | No; send a corrected one, both stay visible |
| Reply to a review | No; Thumbtack allows no edit |
| Set the weekly budget | Yes, set it again |
6 of 12 tools ask first: every write, since each one reaches a customer or your spend. The 6 reads run at once. Turn the wait off per tool for a scheduled run, for example lead replies at 7:00.
Put a fee ceiling in every Opportunity prompt. Thumbtack bills Opportunity fees to your card, outside the weekly budget.
MCP call:
{
"name": "reply_to_lead",
"arguments": {
"lead_id": "519153480500518912",
"body": "Hi! Thanks for reaching out about your kitchen remodel. Could you send a few photos of the space?"
}
}
REST:
curl -X POST https://cotlet.dev/api/v1/thumbtack/leads/519153480500518912/replies \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"body":"Hi! Thanks for reaching out about your kitchen remodel. Could you send a few photos of the space?"}'
Response:
{
"lead_id": "519153480500518912",
"message_id": "msg_7f3a91c2",
"status": "sent",
"sent_at": "2026-10-11T09:14:00-05:00"
}
A cron job or script calls the same tools over REST at /api/v1/thumbtack, with the same key and the same price. A reach-out to an Opportunity that has closed fails and costs nothing. The tools table lists the REST path of each tool.
How much does the Thumbtack MCP server cost?
About $20 a month for a solo pro with about 25 leads a month, 3,480 credits. Lead and Opportunity fees stay with Thumbtack.
| Job | Calls | Credits |
|---|---|---|
| Check for new leads, twice each weekday | 1 × 44 | 440 |
| Read and answer each new lead | 2 × 25 | 500 |
| Follow up in an open conversation | 2 × 20 | 400 |
| Scan Opportunities, daily | 1 × 30 | 300 |
| Quote an Opportunity under your fee limit | 1 × 10 | 100 |
| Estimate from the conversation | 2 × 6 | 120 |
| Answer new reviews, weekly | 2 × 4 | 80 |
| Budget check, weekly | 1 × 4 | 40 |
| Cloud Browser, 30 days | 1,500 | |
| Total | 3,480 |
- Free 7-day trial, no card
- 10 credits per successful call, MCP or REST
- 50 credits a day for the Cloud Browser
- No monthly plan, unlike lead auto-responders
The month is our example. Thumbtack publishes no lead counts; cost write-ups assume about 20 leads a month, and one plumber logged 42 in four weeks. At $25 to $75 a lead, the leads cost far more than the agent. Dollars at the $29 pack rate.
Thumbtack MCP server on GitHub, auto-responders or hosted: which to use
| Option | What it does | Where it stops |
|---|---|---|
| chrischall/thumbtack-mcp | Searches pros by trade and ZIP and reads profiles and reviews, anonymously. | Homeowner side, read only. 0 stars, no license, last commit 26 Oct 2026. |
| markswendsen-code/mcp-thumbtack, marketplace-search-mcp | A connector with no README, and a price search across five marketplaces. | Neither reads a pro's leads. 0 and 5 stars, last commits in March 2026. |
| Thumbtack Front Desk | Thumbtack sends one first message you set to every direct lead. | Same text for everyone; $60 or $500 a month (prices from competitors' pages). |
| Auto-Respond, Tack Tools Pro, LeadTruffle, LeadWinner | AI first replies and follow-ups through Thumbtack's partner access. | Lead replies only; $2.99 a lead to $629 a month. |
| Jobber, Housecall Pro | Copy new Thumbtack leads into your field service app; Housecall Pro also messages. | No Opportunities, estimates in Thumbtack or budget. |
If a fast first message is all you want, an auto-responder with partner access is the safer fit. If your agent should also quote Opportunities, send estimates, answer reviews and watch spend, nothing else reaches those, and Cotlet does it in your own login.
Who runs Cotlet
Behind Cotlet is Take Group sp. z o.o., a software company registered in Poland, EU (VAT PL6342984273) and working since 2019. Its founders are Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Questions about the Thumbtack tools go to contact@cotlet.dev.
Thumbtack API and MCP: questions
How do I get access?
Open a free account at https://cotlet.dev, pick Thumbtack under Integrations in the console and log in to your pro account in its Cloud Browser. The trial starts at once, with no card.
How do I connect Thumbtack to ChatGPT or Claude?
Sign up at cotlet.dev, log in to Thumbtack once in its Cloud Browser and add Cotlet to ChatGPT or Claude, following the steps in your console. No API key is needed. ChatGPT and Claude then work in your Thumbtack account through Cotlet, in their phone apps too.
What can ChatGPT do in Thumbtack?
With Cotlet, ChatGPT, Claude and other AI agents handle jobs like these in Thumbtack: reply to new leads fast; quote Opportunities automatically; send estimates to customers. You ask in plain words, and anything that reaches other people waits for your OK first.
Do Opportunities count against my weekly budget?
No. Thumbtack bills Opportunities separately: you see the cost upfront and are charged with your payment method only if the customer responds to your message. The weekly budget limits spend on leads.
Can my agent change an estimate it already sent?
No. Thumbtack cannot cancel a sent estimate. Your agent sends a corrected estimate as a new one.
Does the official Thumbtack connector in Claude or ChatGPT work for pros?
No. It helps homeowners find, compare and hire pros. Its sign-in asks only for homeowner permissions, so it cannot see your leads, Messages or Opportunities.
Does Thumbtack have webhooks?
Yes, one way. Apps > Manage webhooks sends new leads, messages and reviews to a URL you choose; nothing can reply through it. An agent can run on a schedule instead and call list_leads with since set to the last run.
Can I keep Front Desk or an auto-responder?
Yes. list_leads shows which leads already have a reply, so the agent skips them and works on follow-ups, Opportunities and estimates.
Is the MCP server different from the REST API?
Only the way in. Both carry the same 12 tools with the same inputs and answers, one API key and one price. Agents use MCP; cron jobs and scripts use REST.
Is Cotlet affiliated with Thumbtack?
No. Cotlet is independent and not affiliated with Thumbtack, Inc.
Can I use the Thumbtack API without an AI agent?
Yes. Call Cotlet's REST API from a script or an HTTP step in n8n, Make or Zapier with your Cotlet key. MCP is the alternative for AI agents; you do not need to connect an agent to use REST.
Give your AI agents your signed-in browser.
Product: Integrations · How it works · Pricing · Security
Resources: Blog · API docs · Help center · Changelog · GitHub
Solutions: For developers · For automation agencies
Company: About · AI info: company facts · Contact
Legal: Terms of service · Privacy policy · Refund policy · Acceptable use · Cookie policy · DPA · Subprocessors
Elsewhere: Status page · Cotlet on GitHub · Cotlet on X · Cotlet on LinkedIn · Cotlet on Product Hunt · Cotlet on Crunchbase · Cotlet on SaaSHub
Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. About us
Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.