Licensed plumbers near a job in SF, Oakland, Berkeley and the Tri-Valley, with a booking handoff.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Book a plumber from a find (business_id + find_id). Version 1 is a handoff: Tallyho records the request and returns the plumber's phone number and the questions to ask; nothing is booked until the user calls, so booked is false. Don't send the user's contact details on a handoff; they are never stored either way. Keep the booking_id and call report after the call to the plumber, and again after the job.
Required when there is no find_id; otherwise the search's job is used.
Defaults to the search's environment.
Default: the best available. Version 1 offers only handoff.
The user's details for the business. Never stored; unused on a handoff.
The search this business came from. Required unless `job` is given.
Any stable id for the user; only a salted hash is kept.
On a Tallyho call: the first name the call uses ("calling for Jordan"). Spoken, never stored. Without it, "the property owner".
The booking this one follows, e.g. after a counter-offer.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http tallyho https://mcp.tallyho.so/mcp/v1
Book a plumber from a find (business_id + find_id). Version 1 is a handoff: Tallyho records the request and returns the plumber's phone number and the questions to ask; nothing is booked until the user calls, so booked is false. Don't send the user's contact details on a handoff; they are never stored either way. Keep the booking_id and call report after the call to the plumber, and again after the job.
| Argument | Type | Description |
|---|---|---|
| job | object | Required when there is no find_id; otherwise the search's job is used. |
| test | boolean | Defaults to the search's environment. |
| channel | string | Default: the best available. Version 1 offers only handoff. |
| contact | object | The user's details for the business. Never stored; unused on a handoff. |
| find_id | string | The search this business came from. Required unless `job` is given. |
| promises | array | |
| business_id* | string | |
| principal_ref | string | Any stable id for the user; only a salted hash is kept. |
| principal_name | string | On a Tallyho call: the first name the call uses ("calling for Jordan"). Spoken, never stored. Without it, "the property owner". |
| idempotency_key | string | |
| previous_booking_id | string | The booking this one follows, e.g. after a counter-offer. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"business_id"
],
"properties": {
"job": {
"type": "object",
"required": [
"location"
],
"properties": {
"brand": {
"type": "string",
"pattern": "^[A-Za-z0-9 &.'\\/-]+$",
"maxLength": 40,
"minLength": 1,
"description": "Equipment brand, e.g. \"Rinnai\". Letters, digits and spaces only: it is kept as demand data."
},
"issue": {
"enum": [
"no_hot_water",
"leak",
"clog",
"backup",
"no_water",
"low_pressure",
"running",
"install",
"replace",
"inspect",
"other"
],
"type": "string",
"description": "What is wrong, or what is wanted"
},
"trade": {
"type": "string",
"default": "plumbing",
"maxLength": 40,
"description": "\"plumbing\", the only trade in version 1"
},
"system": {
"enum": [
"water_heater",
"drain",
"sewer",
"toilet",
"faucet_fixture",
"pipes",
"gas_line",
"garbage_disposal",
"water_line",
"other"
],
"type": "string",
"description": "What the job is on"
},
"window": {
"type": "object",
"required": [
"earliest",
"latest"
],
"properties": {
"latest": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"description": "ISO 8601 with a UTC offset"
},
"earliest": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"description": "ISO 8601 with a UTC offset, e.g. 2026-11-02T09:00:00-08:00"
}
},
"description": "When the user can have the plumber come. Must end in the future."
},
"urgency": {
"enum": [
"emergency",
"today",
"this_week",
"flexible"
],
"type": "string",
"default": "flexible",
"description": "emergency = next 4 hours, today = by midnight local (at least 4 hours), this_week = next 7 days; used as the window when none is given"
},
"location": {
"type": "object",
"required": [
"zip"
],
"properties": {
"zip": {
"type": "string",
"maxLength": 10,
"description": "ZIP of the job (5 digits, or ZIP+4), in San Francisco, Oakland, Berkeley or the Tri-Valley (Danville, San Ramon, Dublin, Pleasanton, Livermore), e.g. 94110"
}
}
},
"price_ceiling_cents": {
"type": "integer",
"maximum": 2147483647,
"minimum": 1,
"description": "The most the user will pay, in cents"
},
"max_service_call_cents": {
"type": "integer",
"maximum": 2147483647,
"minimum": 1,
"description": "The most the user will pay just for the plumber to come out and look (a service-call or diagnostic fee), in cents. On a Tallyho call, an offer that names only such a fee is accepted only when it is at or under this."
}
},
"description": "Required when there is no find_id; otherwise the search's job is used."
},
"test": {
"type": "boolean",
"description": "Defaults to the search's environment."
},
"channel": {
"enum": [
"handoff",
"tallyho_call",
"partner_platform"
],
"type": "string",
"description": "Default: the best available. Version 1 offers only handoff."
},
"contact": {
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 100
},
"phone": {
"type": "string",
"maxLength": 40
},
"address": {
"type": "string",
"maxLength": 300
},
"access_notes": {
"type": "string",
"maxLength": 500
}
},
"description": "The user's details for the business. Never stored; unused on a handoff."
},
"find_id": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "The search this business came from. Required unless `job` is given."
},
"promises": {
"type": "array",
"items": {
"enum": [
"does_the_job",
"has_slot_in_window",
"quote_under_ceiling",
"arrives_in_window",
"quote_holds",
"job_completed",
"no_upsell"
],
"type": "string"
},
"maxItems": 7,
"minItems": 1
},
"business_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"principal_ref": {
"type": "string",
"maxLength": 512,
"minLength": 1,
"description": "Any stable id for the user; only a salted hash is kept."
},
"principal_name": {
"type": "string",
"maxLength": 60,
"minLength": 1,
"description": "On a Tallyho call: the first name the call uses (\"calling for Jordan\"). Spoken, never stored. Without it, \"the property owner\"."
},
"idempotency_key": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"previous_booking_id": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "The booking this one follows, e.g. after a counter-offer."
}
}
}Find plumbers for a job in San Francisco, Oakland, Berkeley and the Tri-Valley (Danville, San Ramon, Dublin, Pleasanton, Livermore), ranked by the chance they keep every promise that matters for it: take the job, have a slot in the window, quote within budget, arrive on time, hold the quote, finish, no upsell. Only job.location.zip is required; add system, issue, urgency, window and price_ceiling_cents for a sharper answer. Each candidate has a likelihood per promise with n (the evidence behind it), an 80% interval and freshness, the joint likelihood, and its CSLB license check. n=0 is Tallyho's starting estimate, not a measurement. Free; never contacts a business. Next: book a candidate with this find_id.
| Argument | Type | Description |
|---|---|---|
| job* | object | |
| test | boolean | Mark this search and anything booked from it as a test; test rows never change a likelihood. |
| limit | integer | |
| promises | array | Which promises matter for this job. Default: every promise the spec lets Tallyho judge. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"job"
],
"properties": {
"job": {
"type": "object",
"required": [
"location"
],
"properties": {
"brand": {
"type": "string",
"pattern": "^[A-Za-z0-9 &.'\\/-]+$",
"maxLength": 40,
"minLength": 1,
"description": "Equipment brand, e.g. \"Rinnai\". Letters, digits and spaces only: it is kept as demand data."
},
"issue": {
"enum": [
"no_hot_water",
"leak",
"clog",
"backup",
"no_water",
"low_pressure",
"running",
"install",
"replace",
"inspect",
"other"
],
"type": "string",
"description": "What is wrong, or what is wanted"
},
"trade": {
"type": "string",
"default": "plumbing",
"maxLength": 40,
"description": "\"plumbing\", the only trade in version 1"
},
"system": {
"enum": [
"water_heater",
"drain",
"sewer",
"toilet",
"faucet_fixture",
"pipes",
"gas_line",
"garbage_disposal",
"water_line",
"other"
],
"type": "string",
"description": "What the job is on"
},
"window": {
"type": "object",
"required": [
"earliest",
"latest"
],
"properties": {
"latest": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"description": "ISO 8601 with a UTC offset"
},
"earliest": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"description": "ISO 8601 with a UTC offset, e.g. 2026-11-02T09:00:00-08:00"
}
},
"description": "When the user can have the plumber come. Must end in the future."
},
"urgency": {
"enum": [
"emergency",
"today",
"this_week",
"flexible"
],
"type": "string",
"default": "flexible",
"description": "emergency = next 4 hours, today = by midnight local (at least 4 hours), this_week = next 7 days; used as the window when none is given"
},
"location": {
"type": "object",
"required": [
"zip"
],
"properties": {
"zip": {
"type": "string",
"maxLength": 10,
"description": "ZIP of the job (5 digits, or ZIP+4), in San Francisco, Oakland, Berkeley or the Tri-Valley (Danville, San Ramon, Dublin, Pleasanton, Livermore), e.g. 94110"
}
}
},
"price_ceiling_cents": {
"type": "integer",
"maximum": 2147483647,
"minimum": 1,
"description": "The most the user will pay, in cents"
},
"max_service_call_cents": {
"type": "integer",
"maximum": 2147483647,
"minimum": 1,
"description": "The most the user will pay just for the plumber to come out and look (a service-call or diagnostic fee), in cents. On a Tallyho call, an offer that names only such a fee is accepted only when it is at or under this."
}
}
},
"test": {
"type": "boolean",
"default": false,
"description": "Mark this search and anything booked from it as a test; test rows never change a likelihood."
},
"limit": {
"type": "integer",
"default": 5,
"maximum": 20,
"minimum": 1
},
"promises": {
"type": "array",
"items": {
"enum": [
"does_the_job",
"has_slot_in_window",
"quote_under_ceiling",
"arrives_in_window",
"quote_holds",
"job_completed",
"no_upsell"
],
"type": "string"
},
"maxItems": 7,
"minItems": 1,
"description": "Which promises matter for this job. Default: every promise the spec lets Tallyho judge."
}
}
}Report on a booking, by booking_id, from any session. After the call to the plumber: result confirmed, declined or not_booked, plus the quote (price, slot). After the job: completed, not_completed, no_show or a cancellation, plus the final price and arrival time. Verdicts per promise are kept, broken or unobserved; Tallyho computes price and timing verdicts from the figures. Kept and broken are final. Returns the plumber's updated likelihoods and, if the booking fell through, the next best plumbers from the same search.
| Argument | Type | Description |
|---|---|---|
| quote | object | What the business quoted. Lets Tallyho compute the price and slot verdicts. |
| actual | object | |
| result | string | What happened to the booking. Moves it to this status. |
| verdicts | object | kept, broken or unobserved, per promise in scope |
| booking_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"booking_id"
],
"properties": {
"quote": {
"type": "object",
"properties": {
"window": {
"type": "object",
"required": [
"start",
"end"
],
"properties": {
"end": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"start": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
}
},
"description": "The slot the business offered or booked"
},
"price_cents": {
"type": "integer",
"maximum": 2147483647,
"minimum": 0
}
},
"description": "What the business quoted. Lets Tallyho compute the price and slot verdicts."
},
"actual": {
"type": "object",
"properties": {
"arrived_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"price_cents": {
"type": "integer",
"maximum": 2147483647,
"minimum": 0,
"description": "The final bill"
},
"completed_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
}
}
},
"result": {
"enum": [
"confirmed",
"not_booked",
"declined",
"completed",
"not_completed",
"no_show",
"cancelled_by_user",
"cancelled_by_business"
],
"type": "string",
"description": "What happened to the booking. Moves it to this status."
},
"verdicts": {
"type": "object",
"properties": {
"no_upsell": {
"enum": [
"kept",
"broken",
"unobserved"
],
"type": "string"
},
"quote_holds": {
"enum": [
"kept",
"broken",
"unobserved"
],
"type": "string"
},
"does_the_job": {
"enum": [
"kept",
"broken",
"unobserved"
],
"type": "string"
},
"job_completed": {
"enum": [
"kept",
"broken",
"unobserved"
],
"type": "string"
},
"arrives_in_window": {
"enum": [
"kept",
"broken",
"unobserved"
],
"type": "string"
},
"has_slot_in_window": {
"enum": [
"kept",
"broken",
"unobserved"
],
"type": "string"
},
"quote_under_ceiling": {
"enum": [
"kept",
"broken",
"unobserved"
],
"type": "string"
}
},
"description": "kept, broken or unobserved, per promise in scope"
},
"booking_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
}
}Read a booking as it stands, by booking_id, from any session; holding the booking_id is enough. Works on every booking, handoff ones too. On a booking Tallyho is calling about, status moves from requested to confirmed, counter, declined, not_booked or pending: call status again after check_after_s seconds, and stop when check_after_s is absent. Never tell the user a job is booked unless booked is true. Returns the quote once known, the reason a booking fell through or was countered, the promises still to report, and, if it fell through, the next best plumbers from the same search. Reads only; never contacts a business.
| Argument | Type | Description |
|---|---|---|
| booking_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"booking_id"
],
"properties": {
"booking_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 21, 2026.