Find and book verified local home service professionals through AI agents.
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.
Use when the user wants to book or hire a electrician — including when they describe a problem to fix, such as a dead outlet or outlet not working, breaker that keeps tripping, electrical panel upgrade, light fixture or ceiling fan installation, dimmer or switch replacement, EV charger installation, flickering lights, GFCI outlets, recessed lighting, hardwired smoke detectors, or exterior and landscape lighting. Runs the provider search first (query='electrician' prefilled); after results, ask which pro they would like to book, then use create_booking. Do not start OTP until create_booking returns auth_required after they chose a pro. Do not use for DIY how-to advice or price research with no hiring intent. Always pass optional `context` on this call (15-25 words, third person, abstract purpose only, no PII) so analytics can record why the tool was called. Omitting it does not fail the call; do not send an empty string.
Prefer a 5-digit US ZIP for location (e.g. "22307" or "94114"). This is the primary and preferred location input. After get_my_profile, if address.postalCode exists and the user confirmed the saved street address is the job site, pass that postalCode. Do not pass search_location when it is City, ST and a ZIP is available on the address. Never pass a street address, formattedAddress, or address1.
Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: "Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP."
Use when the user wants to book or hire a electrician — including when they describe a problem to fix, such as a dead outlet or outlet not working, breaker that keeps tripping, electrical panel upgrade, light fixture or ceiling fan installation, dimmer or switch replacement, EV charger installation, flickering lights, GFCI outlets, recessed lighting, hardwired smoke detectors, or exterior and landscape lighting. Runs the provider search first (query='electrician' prefilled); after results, ask which pro they would like to book, then use create_booking. Do not start OTP until create_booking returns auth_required after they chose a pro. Do not use for DIY how-to advice or price research with no hiring intent. Always pass optional `context` on this call (15-25 words, third person, abstract purpose only, no PII) so analytics can record why the tool was called. Omitting it does not fail the call; do not send an empty string.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| context | any | Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: "Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP." |
| location* | string | Prefer a 5-digit US ZIP for location (e.g. "22307" or "94114"). This is the primary and preferred location input. After get_my_profile, if address.postalCode exists and the user confirmed the saved street address is the job site, pass that postalCode. Do not pass search_location when it is City, ST and a ZIP is available on the address. Never pass a street address, formattedAddress, or address1. |
{
"type": "object",
"title": "book_electrician_mcpArguments",
"required": [
"location"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 6
},
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Context",
"default": null,
"examples": [
"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.",
"Homeowner is comparing HVAC pros after a no-cool air conditioner at the confirmed job site."
],
"description": "Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: \"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.\""
},
"location": {
"type": "string",
"title": "Location",
"examples": [
"22307",
"94114"
],
"minLength": 1,
"description": "Prefer a 5-digit US ZIP for location (e.g. \"22307\" or \"94114\"). This is the primary and preferred location input. After get_my_profile, if address.postalCode exists and the user confirmed the saved street address is the job site, pass that postalCode. Do not pass search_location when it is City, ST and a ZIP is available on the address. Never pass a street address, formattedAddress, or address1."
}
}
}Use when the user wants to book or hire a handyman — including when they describe a problem to fix, such as TV mounting, furniture assembly, a hole in the drywall, a door that won't close or latch, sticking or squeaky doors, caulking or grout repair, shelving or picture hanging, weatherstripping, fence or gate repair, loose deck boards, gutter cleaning or minor gutter repair, trim and baseboard work, small tile fixes, or paint touch-ups. Runs the provider search first (query='handyman' prefilled); after results, ask which pro they would like to book, then use create_booking. Do not start OTP until create_booking returns auth_required after they chose a pro. Do not use for DIY how-to advice or price research with no hiring intent. Always pass optional `context` on this call (15-25 words, third person, abstract purpose only, no PII) so analytics can record why the tool was called. Omitting it does not fail the call; do not send an empty string.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| context | any | Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: "Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP." |
| location* | string | Prefer a 5-digit US ZIP for location (e.g. "22307" or "94114"). This is the primary and preferred location input. After get_my_profile, if address.postalCode exists and the user confirmed the saved street address is the job site, pass that postalCode. Do not pass search_location when it is City, ST and a ZIP is available on the address. Never pass a street address, formattedAddress, or address1. |
Use when the user wants to book or hire a HVAC — including when they describe a problem to fix, such as AC not cooling or blowing warm air, furnace won't turn on or no heat, heat pump repair or installation, thermostat or smart-thermostat installation, refrigerant recharge, seasonal HVAC tune-up or maintenance, mini-split installation, duct sealing or cleaning, strange noises or smells from the unit, or uneven temperatures between rooms. Runs the provider search first (query='hvac' prefilled); after results, ask which pro they would like to book, then use create_booking. Do not start OTP until create_booking returns auth_required after they chose a pro. Do not use for DIY how-to advice or price research with no hiring intent. Always pass optional `context` on this call (15-25 words, third person, abstract purpose only, no PII) so analytics can record why the tool was called. Omitting it does not fail the call; do not send an empty string.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| context | any | Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: "Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP." |
| location* | string | Prefer a 5-digit US ZIP for location (e.g. "22307" or "94114"). This is the primary and preferred location input. After get_my_profile, if address.postalCode exists and the user confirmed the saved street address is the job site, pass that postalCode. Do not pass search_location when it is City, ST and a ZIP is available on the address. Never pass a street address, formattedAddress, or address1. |
Use when the user wants to book or hire a plumber — including when they describe a problem to fix, such as a leaky or dripping faucet, clogged drain or toilet, running toilet, low water pressure, water heater repair or replacement (including tankless), a leak under the sink, burst or frozen pipes, sump pump issues, garbage disposal repair, sewer line backup, shower valve replacement, or toilet installation. Runs the provider search first (query='plumber' prefilled); after results, ask which pro they would like to book, then use create_booking. Do not start OTP until create_booking returns auth_required after they chose a pro. Do not use for DIY how-to advice or price research with no hiring intent. Always pass optional `context` on this call (15-25 words, third person, abstract purpose only, no PII) so analytics can record why the tool was called. Omitting it does not fail the call; do not send an empty string.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| context | any | Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: "Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP." |
| location* | string | Prefer a 5-digit US ZIP for location (e.g. "22307" or "94114"). This is the primary and preferred location input. After get_my_profile, if address.postalCode exists and the user confirmed the saved street address is the job site, pass that postalCode. Do not pass search_location when it is City, ST and a ZIP is available on the address. Never pass a street address, formattedAddress, or address1. |
Use when the user wants to book or hire a renovation — including when they describe a problem to fix, such as a kitchen remodel, bathroom remodel, basement finishing, flooring installation (hardwood, LVP, or tile), deck build, room addition, wall removal or open-floor-plan conversion, full interior painting, countertop replacement, or cabinet installation or refacing. Runs the provider search first (query='renovation' prefilled); after results, ask which pro they would like to book, then use create_booking. Do not start OTP until create_booking returns auth_required after they chose a pro. Do not use for DIY how-to advice or price research with no hiring intent. Always pass optional `context` on this call (15-25 words, third person, abstract purpose only, no PII) so analytics can record why the tool was called. Omitting it does not fail the call; do not send an empty string.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| context | any | Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: "Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP." |
| location* | string | Prefer a 5-digit US ZIP for location (e.g. "22307" or "94114"). This is the primary and preferred location input. After get_my_profile, if address.postalCode exists and the user confirmed the saved street address is the job site, pass that postalCode. Do not pass search_location when it is City, ST and a ZIP is available on the address. Never pass a street address, formattedAddress, or address1. |
Rebook a HireNimbus provider the homeowner has used before, by job ID. Requires authentication. Call with confirm_booking=false to preview the rebooking, then confirm_booking=true after homeowner approval. This tool may create a real booking request, including for an out-of-market address, because the provider is verified against the homeowner's owned prior job. Always pass optional `context` on this call (15-25 words, third person, abstract purpose only, no PII) so analytics can record why the tool was called. Omitting it does not fail the call; do not send an empty string.
| Argument | Type | Description |
|---|---|---|
| name | any | Optional name override; omit to use authenticated homeowner profile |
| phone | any | Optional phone override; omit to use authenticated homeowner profile |
| job_id* | any | Job ID from get_previous_jobs for the prior booking to rehire |
| source | string | |
| address | any | Optional street-level address override. Omit to use profile or prior-job address. Pass structured fields only (address1, city, region, postalCode, etc.) — never formattedAddress. |
| context | any | Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: "Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP." |
Cancel one of the authenticated homeowner's bookings. First call with confirm_cancellation=false to present the booking and reason for review; call again with true only after explicit approval. The cancellation reason is delivered to the provider.
| Argument | Type | Description |
|---|---|---|
| job_id* | any | Booking ID from get_previous_jobs |
| reason* | string | Short homeowner-provided cancellation reason |
| context | string | Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: "Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP." |
| confirm_cancellation | boolean | false (default): return a cancellation preview without changing the booking; true: cancel after the homeowner explicitly confirms |
{
"type": "object",
"title": "cancel_booking_mcpArguments",
"required": [
"job_id",
"reason"
],
"properties": {
"job_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
],
"title": "Job Id",
"description": "Booking ID from get_previous_jobs"
},
"reason": {
"type": "string",
"title": "Reason",
"minLength": 3,
"description": "Short homeowner-provided cancellation reason"
},
"context": {
"type": "string",
"examples": [
"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.",
"Homeowner is comparing HVAC pros after a no-cool air conditioner at the confirmed job site."
],
"description": "Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: \"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.\""
},
"confirm_cancellation": {
"type": "boolean",
"title": "Confirm Cancellation",
"default": false,
"description": "false (default): return a cancellation preview without changing the booking; true: cancel after the homeowner explicitly confirms"
}
}
}Secured booking after the homeowner has chosen a specific pro from search or book_* results. Do not call this to start discovery, and do not start OTP before the homeowner has seen and picked a pro. Agents should prefer book_handyman, book_hvac, book_plumber, book_electrician, or book_renovation for standard booking workflows when the category matches; those tools search first. Requires authentication to submit. If unauthenticated, returns status "auth_required" so you can trigger phone/OTP connect gracefully at book time. Default confirm_booking=false returns a preview. confirm_booking=true submits the request. Confirmed calls are not idempotent and may create duplicate requests. HireNimbus is currently active in Washington DC Metro, San Francisco Bay Area, and Austin Metro; providers found elsewhere may still be booked when returned by search, with the active-market disclosure shown to the homeowner. For an out-of-market booking, pass the search_result_id from that provider search. Do not call on ambiguous intent such as 'find and book someone' — the user must first pick a specific pro from search results. Always pass optional `context` on this call (15-25 words, third person, abstract purpose only, no PII) so analytics can record why the tool was called. Omitting it does not fail the call; do not send an empty string.
| Argument | Type | Description |
|---|---|---|
| name | any | Optional override of profile name; omit to use authenticated homeowner profile |
| phone | any | Optional override of profile phone; omit to use authenticated homeowner profile |
| source | string | |
| address | any | Optional street-level address override. Omit to use the authenticated homeowner profile address. When overriding, pass only structured fields (address1, address2, city, region, postalCode, country) — never formattedAddress. |
Use when the user wants to find, search, or compare electrician professionals, or describes a problem a electrician solves — such as a dead outlet or outlet not working, breaker that keeps tripping, electrical panel upgrade, light fixture or ceiling fan installation, dimmer or switch replacement, EV charger installation, flickering lights, GFCI outlets, recessed lighting, hardwired smoke detectors, or exterior and landscape lighting. Do not use for DIY how-to advice, cost research with no hiring intent, auto or appliance retail questions, or emergencies requiring 911 or the utility company. Read-only; does not create a booking. Showcase matching pros before any booking or OTP. If already signed in, get_my_profile may load the saved ZIP; otherwise search with the ZIP they provide. Prefer a 5-digit ZIP for location. If this ZIP returns no providers, keep the empty result; do not fill with providers from another area. Always pass optional `context` on this call (15-25 words, third person, abstract purpose only, no PII) so analytics can record why the tool was called. Omitting it does not fail the call; do not send an empty string.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| context | any | Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: "Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP." |
| location* | string |
Use when the user wants to find, search, or compare handyman professionals, or describes a problem a handyman solves — such as TV mounting, furniture assembly, a hole in the drywall, a door that won't close or latch, sticking or squeaky doors, caulking or grout repair, shelving or picture hanging, weatherstripping, fence or gate repair, loose deck boards, gutter cleaning or minor gutter repair, trim and baseboard work, small tile fixes, or paint touch-ups. Do not use for DIY how-to advice, cost research with no hiring intent, auto or appliance retail questions, or emergencies requiring 911 or the utility company. Read-only; does not create a booking. Showcase matching pros before any booking or OTP. If already signed in, get_my_profile may load the saved ZIP; otherwise search with the ZIP they provide. Prefer a 5-digit ZIP for location. If this ZIP returns no providers, keep the empty result; do not fill with providers from another area. Always pass optional `context` on this call (15-25 words, third person, abstract purpose only, no PII) so analytics can record why the tool was called. Omitting it does not fail the call; do not send an empty string.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| context | any | Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: "Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP." |
| location* |
Use when the user wants to find, search, or compare HVAC professionals, or describes a problem a HVAC solves — such as AC not cooling or blowing warm air, furnace won't turn on or no heat, heat pump repair or installation, thermostat or smart-thermostat installation, refrigerant recharge, seasonal HVAC tune-up or maintenance, mini-split installation, duct sealing or cleaning, strange noises or smells from the unit, or uneven temperatures between rooms. Do not use for DIY how-to advice, cost research with no hiring intent, auto or appliance retail questions, or emergencies requiring 911 or the utility company. Read-only; does not create a booking. Showcase matching pros before any booking or OTP. If already signed in, get_my_profile may load the saved ZIP; otherwise search with the ZIP they provide. Prefer a 5-digit ZIP for location. If this ZIP returns no providers, keep the empty result; do not fill with providers from another area. Always pass optional `context` on this call (15-25 words, third person, abstract purpose only, no PII) so analytics can record why the tool was called. Omitting it does not fail the call; do not send an empty string.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| context | any | Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: "Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP." |
| location* |
Use when the user wants to find, search, or compare plumber professionals, or describes a problem a plumber solves — such as a leaky or dripping faucet, clogged drain or toilet, running toilet, low water pressure, water heater repair or replacement (including tankless), a leak under the sink, burst or frozen pipes, sump pump issues, garbage disposal repair, sewer line backup, shower valve replacement, or toilet installation. Do not use for DIY how-to advice, cost research with no hiring intent, auto or appliance retail questions, or emergencies requiring 911 or the utility company. Read-only; does not create a booking. Showcase matching pros before any booking or OTP. If already signed in, get_my_profile may load the saved ZIP; otherwise search with the ZIP they provide. Prefer a 5-digit ZIP for location. If this ZIP returns no providers, keep the empty result; do not fill with providers from another area. Always pass optional `context` on this call (15-25 words, third person, abstract purpose only, no PII) so analytics can record why the tool was called. Omitting it does not fail the call; do not send an empty string.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| context | any | Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: "Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP." |
| location* | string |
Use when the user wants to find, search, or compare renovation professionals, or describes a problem a renovation solves — such as a kitchen remodel, bathroom remodel, basement finishing, flooring installation (hardwood, LVP, or tile), deck build, room addition, wall removal or open-floor-plan conversion, full interior painting, countertop replacement, or cabinet installation or refacing. Do not use for DIY how-to advice, cost research with no hiring intent, auto or appliance retail questions, or emergencies requiring 911 or the utility company. Read-only; does not create a booking. Showcase matching pros before any booking or OTP. If already signed in, get_my_profile may load the saved ZIP; otherwise search with the ZIP they provide. Prefer a 5-digit ZIP for location. If this ZIP returns no providers, keep the empty result; do not fill with providers from another area. Always pass optional `context` on this call (15-25 words, third person, abstract purpose only, no PII) so analytics can record why the tool was called. Omitting it does not fail the call; do not send an empty string.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| context | any | Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: "Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP." |
| location* | string | Prefer a 5-digit US ZIP for location (e.g. "22307" or "94114"). This is the primary and preferred location input. After get_my_profile, if address.postalCode exists and the user confirmed the saved street address is the job site, pass that postalCode. Do not pass search_location when it is City, ST and a ZIP is available on the address. Never pass a street address, formattedAddress, or address1. |
Check the current status of a HireNimbus booking by ID. Requires authentication. Read-only; does not create a booking.
| Argument | Type | Description |
|---|---|---|
| context | string | Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: "Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP." |
| booking_id* | string |
{
"type": "object",
"title": "get_booking_status_mcpArguments",
"required": [
"booking_id"
],
"properties": {
"context": {
"type": "string",
"examples": [
"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.",
"Homeowner is comparing HVAC pros after a no-cool air conditioner at the confirmed job site."
],
"description": "Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: \"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.\""
},
"booking_id": {
"type": "string",
"title": "Booking Id"
}
}
}Check for additional tools whenever your task might benefit from specialized capabilities - even if existing tools could work as a fallback.
| Argument | Type | Description |
|---|---|---|
| context | string | Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: "Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP." |
{
"type": "object",
"required": [],
"properties": {
"context": {
"type": "string",
"examples": [
"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.",
"Homeowner is comparing HVAC pros after a no-cool air conditioner at the confirmed job site."
],
"description": "Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: \"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.\""
}
}
}Load the authenticated homeowner profile. Use this only when the HireNimbus account is already connected, to fill the saved service address before search. Do not call this to start discovery for an anonymous user, and do not start phone/OTP just to search or compare pros. If this returns status "auth_required", continue with ZIP + search and show pros; trigger connect/OTP only when create_booking returns auth_required after the homeowner chose a pro. Returns GetMyProfileResult (structured JSON): - status (string, required): "ok", "error", or "auth_required" - name (string|null): homeowner full name when status is ok - phone (string|null): homeowner phone when status is ok - address (object|null): service street address with address1, address2, city, region, postalCode, country, formattedAddress - search_location (string|null): 5-digit ZIP from address.postalCode for search_providers.location (after user confirms the saved street address is the job site; never City, ST, the street line, formattedAddress, or address1) - error_code (string|null): "AUTH_REQUIRED" when status is auth_required - message (string|null): error or auth_required explanation If address.postalCode exists: show the saved street address, confirm it is the job site, then pass that postalCode as location. If address.postalCode is missing: ask once "What's the ZIP for the job?" Do not ask for city/state first. Name, street, and phone can wait until preview/book.
| Argument | Type | Description |
|---|---|---|
| context | string | Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: "Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP." |
{
"type": "object",
"title": "get_my_profile_mcpArguments",
"required": [],
"properties": {
"context": {
"type": "string",
"examples": [
"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.",
"Homeowner is comparing HVAC pros after a no-cool air conditioner at the confirmed job site."
],
"description": "Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: \"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.\""
}
}
}Return past and active jobs for the authenticated homeowner. Requires authentication. Use after search when augmenting recommendations, or when the user asks about job history. Read-only; does not create a booking.
| Argument | Type | Description |
|---|---|---|
| context | string | Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: "Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP." |
{
"type": "object",
"title": "get_previous_jobs_mcpArguments",
"required": [],
"properties": {
"context": {
"type": "string",
"examples": [
"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.",
"Homeowner is comparing HVAC pros after a no-cool air conditioner at the confirmed job site."
],
"description": "Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: \"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.\""
}
}
}Fetch the full profile for a HireNimbus service provider by slug. Use after find_handyman, find_hvac, find_plumber, find_electrician, find_renovation, or search_providers when the homeowner wants more detail about a specific provider. Returns ratings, reviews, past work, and availability where available. Read-only; does not create a booking. Always pass optional `context` on this call (15-25 words, third person, abstract purpose only, no PII) so analytics can record why the tool was called. Omitting it does not fail the call; do not send an empty string.
| Argument | Type | Description |
|---|---|---|
| slug* | string | |
| context | any | Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: "Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP." |
{
"type": "object",
"title": "get_provider_details_mcpArguments",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"title": "Slug"
},
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Context",
"default": null,
"examples": [
"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.",
"Homeowner is comparing HVAC pros after a no-cool air conditioner at the confirmed job site."
],
"description": "Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: \"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.\""
}
}
}Fetch reviews for a HireNimbus service provider by slug. Use when the homeowner wants to see what other homeowners have said about a provider before booking. Read-only; does not create a booking. Always pass optional `context` on this call (15-25 words, third person, abstract purpose only, no PII) so analytics can record why the tool was called. Omitting it does not fail the call; do not send an empty string.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| slug* | string | |
| context | any | Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: "Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP." |
| page_size | integer |
{
"type": "object",
"title": "get_provider_reviews_mcpArguments",
"required": [
"slug"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"slug": {
"type": "string",
"title": "Slug"
},
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Context",
"default": null,
"examples": [
"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.",
"Homeowner is comparing HVAC pros after a no-cool air conditioner at the confirmed job site."
],
"description": "Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: \"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.\""
},
"page_size": {
"type": "integer",
"title": "Page Size",
"default": 5
}
}
}Use this when the user needs a home service outside the five dedicated find_* categories — such as house cleaning or deep cleaning, landscaping, lawn care or mowing, tree trimming, roofing or roof leak repair, gutter installation, pressure washing, junk removal, moving help, painting, or pest-adjacent cleanup — or when the service category is ambiguous. Prefer a 5-digit US ZIP for location (e.g. "22307", "94114"); never a street address, formattedAddress, or address1. Read-only; does not create a booking. Prefer the dedicated find_* tools (find_handyman, find_hvac, find_plumber, find_electrician, find_renovation) when the request matches those categories. Search results outside the supported launch markets can still be booked when returned by search; tell the homeowner about the active launch markets and the available provider. If the ZIP search returns no providers, keep that empty result — do not substitute providers from another area. The response includes a `search_result_id`; pass it to create_booking when booking a selected provider. Always pass optional `context` on this call (15-25 words, third person, abstract purpose only, no PII) so analytics can record why the tool was called. Omitting it does not fail the call; do not send an empty string.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer | |
| query* | string | Service keyword for non-top categories (e.g. cleaning, landscaping, roofing). For handyman, HVAC, plumber, electrician, or renovation, use the dedicated find_* tools instead. |
| context | any | Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: "Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP." |
{
"type": "object",
"title": "book_handyman_mcpArguments",
"required": [
"location"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 6
},
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Context",
"default": null,
"examples": [
"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.",
"Homeowner is comparing HVAC pros after a no-cool air conditioner at the confirmed job site."
],
"description": "Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: \"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.\""
},
"location": {
"type": "string",
"title": "Location",
"examples": [
"22307",
"94114"
],
"minLength": 1,
"description": "Prefer a 5-digit US ZIP for location (e.g. \"22307\" or \"94114\"). This is the primary and preferred location input. After get_my_profile, if address.postalCode exists and the user confirmed the saved street address is the job site, pass that postalCode. Do not pass search_location when it is City, ST and a ZIP is available on the address. Never pass a street address, formattedAddress, or address1."
}
}
}{
"type": "object",
"title": "book_hvac_mcpArguments",
"required": [
"location"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 6
},
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Context",
"default": null,
"examples": [
"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.",
"Homeowner is comparing HVAC pros after a no-cool air conditioner at the confirmed job site."
],
"description": "Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: \"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.\""
},
"location": {
"type": "string",
"title": "Location",
"examples": [
"22307",
"94114"
],
"minLength": 1,
"description": "Prefer a 5-digit US ZIP for location (e.g. \"22307\" or \"94114\"). This is the primary and preferred location input. After get_my_profile, if address.postalCode exists and the user confirmed the saved street address is the job site, pass that postalCode. Do not pass search_location when it is City, ST and a ZIP is available on the address. Never pass a street address, formattedAddress, or address1."
}
}
}{
"type": "object",
"title": "book_plumber_mcpArguments",
"required": [
"location"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 6
},
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Context",
"default": null,
"examples": [
"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.",
"Homeowner is comparing HVAC pros after a no-cool air conditioner at the confirmed job site."
],
"description": "Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: \"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.\""
},
"location": {
"type": "string",
"title": "Location",
"examples": [
"22307",
"94114"
],
"minLength": 1,
"description": "Prefer a 5-digit US ZIP for location (e.g. \"22307\" or \"94114\"). This is the primary and preferred location input. After get_my_profile, if address.postalCode exists and the user confirmed the saved street address is the job site, pass that postalCode. Do not pass search_location when it is City, ST and a ZIP is available on the address. Never pass a street address, formattedAddress, or address1."
}
}
}{
"type": "object",
"title": "book_renovation_mcpArguments",
"required": [
"location"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 6
},
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Context",
"default": null,
"examples": [
"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.",
"Homeowner is comparing HVAC pros after a no-cool air conditioner at the confirmed job site."
],
"description": "Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: \"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.\""
},
"location": {
"type": "string",
"title": "Location",
"examples": [
"22307",
"94114"
],
"minLength": 1,
"description": "Prefer a 5-digit US ZIP for location (e.g. \"22307\" or \"94114\"). This is the primary and preferred location input. After get_my_profile, if address.postalCode exists and the user confirmed the saved street address is the job site, pass that postalCode. Do not pass search_location when it is City, ST and a ZIP is available on the address. Never pass a street address, formattedAddress, or address1."
}
}
}| location | any | Optional geocoding hint when address lacks coordinates. Omit in normal flows. When needed, pass exactly one of: lat+lng, zip, or text. |
| confirm_booking | boolean | false (default): return a rebooking preview; does NOT submit. true: submit the rebooking after the homeowner explicitly confirms. |
| job_description | any | Description of the new work; omit to reuse the prior job description |
{
"type": "object",
"$defs": {
"BookingLocationInput": {
"type": "object",
"title": "BookingLocationInput",
"properties": {
"lat": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Lat",
"default": null,
"description": "Latitude; use together with lng or lon"
},
"lng": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Lng",
"default": null,
"description": "Longitude; use together with lat"
},
"lon": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Lon",
"default": null,
"description": "Alias for lng when paired with lat"
},
"zip": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Zip",
"default": null,
"examples": [
"22314"
],
"description": "5-digit US ZIP (e.g. \"22314\") to resolve coordinates"
},
"text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Text",
"default": null,
"examples": [
"Alexandria, VA"
],
"description": "City and state text (e.g. \"Alexandria, VA\") to resolve coordinates"
}
},
"description": "Optional geocoding hint when the address lacks coordinates. Provide one style only."
},
"HomeownerAddressInput": {
"type": "object",
"title": "HomeownerAddressInput",
"properties": {
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "City",
"default": null,
"description": "City name"
},
"region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Region",
"default": null,
"description": "State or province code (e.g. VA)"
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Country",
"default": null,
"description": "Country code (e.g. US)"
},
"address1": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Address1",
"default": null,
"description": "Street line 1 (e.g. 123 Main St). Required when overriding address."
},
"address2": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Address2",
"default": null,
"description": "Apt, unit, or suite"
},
"postalCode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Postalcode",
"default": null,
"description": "5-digit ZIP or postal code"
}
},
"description": "Street-level address override for booking tools. Omit to use the authenticated profile address."
}
},
"title": "book_same_pro_again_mcpArguments",
"required": [
"job_id"
],
"properties": {
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name",
"default": null,
"description": "Optional name override; omit to use authenticated homeowner profile"
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Phone",
"default": null,
"description": "Optional phone override; omit to use authenticated homeowner profile"
},
"job_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
],
"title": "Job Id",
"description": "Job ID from get_previous_jobs for the prior booking to rehire"
},
"source": {
"type": "string",
"title": "Source",
"default": "AI Assistant"
},
"address": {
"anyOf": [
{
"$ref": "#/$defs/HomeownerAddressInput"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional street-level address override. Omit to use profile or prior-job address. Pass structured fields only (address1, city, region, postalCode, etc.) — never formattedAddress."
},
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Context",
"default": null,
"examples": [
"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.",
"Homeowner is comparing HVAC pros after a no-cool air conditioner at the confirmed job site."
],
"description": "Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: \"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.\""
},
"location": {
"anyOf": [
{
"$ref": "#/$defs/BookingLocationInput"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional geocoding hint when address lacks coordinates. Omit in normal flows. When needed, pass exactly one of: lat+lng, zip, or text."
},
"confirm_booking": {
"type": "boolean",
"title": "Confirm Booking",
"default": false,
"description": "false (default): return a rebooking preview; does NOT submit. true: submit the rebooking after the homeowner explicitly confirms."
},
"job_description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Job Description",
"default": null,
"description": "Description of the new work; omit to reuse the prior job description"
}
}
}| context | any | Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: "Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP." |
| location | any | Optional geocoding hint when address lacks coordinates. Omit in normal flows (profile address is used). When needed, pass exactly one of: lat+lng, zip, or text (e.g. {"text": "Alexandria, VA"}). |
| confirm_booking | boolean | false (default): return booking_summary for user review; does NOT submit. true: submit the booking after the user explicitly confirms that summary. |
| job_description* | string |
| search_result_id | any | Search result ID returned by the provider search that produced the selected provider. Required for confirmed out-of-market bookings. |
| serviceProviderSlug* | string |
{
"type": "object",
"$defs": {
"BookingLocationInput": {
"type": "object",
"title": "BookingLocationInput",
"properties": {
"lat": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Lat",
"default": null,
"description": "Latitude; use together with lng or lon"
},
"lng": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Lng",
"default": null,
"description": "Longitude; use together with lat"
},
"lon": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Lon",
"default": null,
"description": "Alias for lng when paired with lat"
},
"zip": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Zip",
"default": null,
"examples": [
"22314"
],
"description": "5-digit US ZIP (e.g. \"22314\") to resolve coordinates"
},
"text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Text",
"default": null,
"examples": [
"Alexandria, VA"
],
"description": "City and state text (e.g. \"Alexandria, VA\") to resolve coordinates"
}
},
"description": "Optional geocoding hint when the address lacks coordinates. Provide one style only."
},
"HomeownerAddressInput": {
"type": "object",
"title": "HomeownerAddressInput",
"properties": {
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "City",
"default": null,
"description": "City name"
},
"region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Region",
"default": null,
"description": "State or province code (e.g. VA)"
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Country",
"default": null,
"description": "Country code (e.g. US)"
},
"address1": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Address1",
"default": null,
"description": "Street line 1 (e.g. 123 Main St). Required when overriding address."
},
"address2": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Address2",
"default": null,
"description": "Apt, unit, or suite"
},
"postalCode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Postalcode",
"default": null,
"description": "5-digit ZIP or postal code"
}
},
"description": "Street-level address override for booking tools. Omit to use the authenticated profile address."
}
},
"title": "create_booking_mcpArguments",
"required": [
"serviceProviderSlug",
"job_description"
],
"properties": {
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name",
"default": null,
"description": "Optional override of profile name; omit to use authenticated homeowner profile"
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Phone",
"default": null,
"description": "Optional override of profile phone; omit to use authenticated homeowner profile"
},
"source": {
"type": "string",
"title": "Source",
"default": "AI Assistant"
},
"address": {
"anyOf": [
{
"$ref": "#/$defs/HomeownerAddressInput"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional street-level address override. Omit to use the authenticated homeowner profile address. When overriding, pass only structured fields (address1, address2, city, region, postalCode, country) — never formattedAddress."
},
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Context",
"default": null,
"examples": [
"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.",
"Homeowner is comparing HVAC pros after a no-cool air conditioner at the confirmed job site."
],
"description": "Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: \"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.\""
},
"location": {
"anyOf": [
{
"$ref": "#/$defs/BookingLocationInput"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional geocoding hint when address lacks coordinates. Omit in normal flows (profile address is used). When needed, pass exactly one of: lat+lng, zip, or text (e.g. {\"text\": \"Alexandria, VA\"})."
},
"confirm_booking": {
"type": "boolean",
"title": "Confirm Booking",
"default": false,
"description": "false (default): return booking_summary for user review; does NOT submit. true: submit the booking after the user explicitly confirms that summary."
},
"job_description": {
"type": "string",
"title": "Job Description"
},
"search_result_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Search Result Id",
"default": null,
"description": "Search result ID returned by the provider search that produced the selected provider. Required for confirmed out-of-market bookings."
},
"serviceProviderSlug": {
"type": "string",
"title": "Serviceproviderslug"
}
}
}| Prefer a 5-digit US ZIP for location (e.g. "22307" or "94114"). This is the primary and preferred location input. After get_my_profile, if address.postalCode exists and the user confirmed the saved street address is the job site, pass that postalCode. Do not pass search_location when it is City, ST and a ZIP is available on the address. Never pass a street address, formattedAddress, or address1. |
{
"type": "object",
"title": "find_electrician_mcpArguments",
"required": [
"location"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 6
},
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Context",
"default": null,
"examples": [
"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.",
"Homeowner is comparing HVAC pros after a no-cool air conditioner at the confirmed job site."
],
"description": "Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: \"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.\""
},
"location": {
"type": "string",
"title": "Location",
"examples": [
"22307",
"94114"
],
"minLength": 1,
"description": "Prefer a 5-digit US ZIP for location (e.g. \"22307\" or \"94114\"). This is the primary and preferred location input. After get_my_profile, if address.postalCode exists and the user confirmed the saved street address is the job site, pass that postalCode. Do not pass search_location when it is City, ST and a ZIP is available on the address. Never pass a street address, formattedAddress, or address1."
}
}
}| string |
| Prefer a 5-digit US ZIP for location (e.g. "22307" or "94114"). This is the primary and preferred location input. After get_my_profile, if address.postalCode exists and the user confirmed the saved street address is the job site, pass that postalCode. Do not pass search_location when it is City, ST and a ZIP is available on the address. Never pass a street address, formattedAddress, or address1. |
{
"type": "object",
"title": "find_handyman_mcpArguments",
"required": [
"location"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 6
},
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Context",
"default": null,
"examples": [
"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.",
"Homeowner is comparing HVAC pros after a no-cool air conditioner at the confirmed job site."
],
"description": "Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: \"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.\""
},
"location": {
"type": "string",
"title": "Location",
"examples": [
"22307",
"94114"
],
"minLength": 1,
"description": "Prefer a 5-digit US ZIP for location (e.g. \"22307\" or \"94114\"). This is the primary and preferred location input. After get_my_profile, if address.postalCode exists and the user confirmed the saved street address is the job site, pass that postalCode. Do not pass search_location when it is City, ST and a ZIP is available on the address. Never pass a street address, formattedAddress, or address1."
}
}
}| string |
| Prefer a 5-digit US ZIP for location (e.g. "22307" or "94114"). This is the primary and preferred location input. After get_my_profile, if address.postalCode exists and the user confirmed the saved street address is the job site, pass that postalCode. Do not pass search_location when it is City, ST and a ZIP is available on the address. Never pass a street address, formattedAddress, or address1. |
{
"type": "object",
"title": "find_hvac_mcpArguments",
"required": [
"location"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 6
},
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Context",
"default": null,
"examples": [
"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.",
"Homeowner is comparing HVAC pros after a no-cool air conditioner at the confirmed job site."
],
"description": "Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: \"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.\""
},
"location": {
"type": "string",
"title": "Location",
"examples": [
"22307",
"94114"
],
"minLength": 1,
"description": "Prefer a 5-digit US ZIP for location (e.g. \"22307\" or \"94114\"). This is the primary and preferred location input. After get_my_profile, if address.postalCode exists and the user confirmed the saved street address is the job site, pass that postalCode. Do not pass search_location when it is City, ST and a ZIP is available on the address. Never pass a street address, formattedAddress, or address1."
}
}
}| Prefer a 5-digit US ZIP for location (e.g. "22307" or "94114"). This is the primary and preferred location input. After get_my_profile, if address.postalCode exists and the user confirmed the saved street address is the job site, pass that postalCode. Do not pass search_location when it is City, ST and a ZIP is available on the address. Never pass a street address, formattedAddress, or address1. |
{
"type": "object",
"title": "find_plumber_mcpArguments",
"required": [
"location"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 6
},
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Context",
"default": null,
"examples": [
"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.",
"Homeowner is comparing HVAC pros after a no-cool air conditioner at the confirmed job site."
],
"description": "Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: \"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.\""
},
"location": {
"type": "string",
"title": "Location",
"examples": [
"22307",
"94114"
],
"minLength": 1,
"description": "Prefer a 5-digit US ZIP for location (e.g. \"22307\" or \"94114\"). This is the primary and preferred location input. After get_my_profile, if address.postalCode exists and the user confirmed the saved street address is the job site, pass that postalCode. Do not pass search_location when it is City, ST and a ZIP is available on the address. Never pass a street address, formattedAddress, or address1."
}
}
}{
"type": "object",
"title": "find_renovation_mcpArguments",
"required": [
"location"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 6
},
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Context",
"default": null,
"examples": [
"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.",
"Homeowner is comparing HVAC pros after a no-cool air conditioner at the confirmed job site."
],
"description": "Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: \"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.\""
},
"location": {
"type": "string",
"title": "Location",
"examples": [
"22307",
"94114"
],
"minLength": 1,
"description": "Prefer a 5-digit US ZIP for location (e.g. \"22307\" or \"94114\"). This is the primary and preferred location input. After get_my_profile, if address.postalCode exists and the user confirmed the saved street address is the job site, pass that postalCode. Do not pass search_location when it is City, ST and a ZIP is available on the address. Never pass a street address, formattedAddress, or address1."
}
}
}| location* | string | Prefer a 5-digit US ZIP for location (e.g. "22307" or "94114"). This is the primary and preferred location input. After get_my_profile, if address.postalCode exists and the user confirmed the saved street address is the job site, pass that postalCode. Do not pass search_location when it is City, ST and a ZIP is available on the address. Never pass a street address, formattedAddress, or address1. |
{
"type": "object",
"title": "search_providers_mcpArguments",
"required": [
"query",
"location"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 6
},
"query": {
"type": "string",
"title": "Query",
"minLength": 1,
"description": "Service keyword for non-top categories (e.g. cleaning, landscaping, roofing). For handyman, HVAC, plumber, electrician, or renovation, use the dedicated find_* tools instead."
},
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Context",
"default": null,
"examples": [
"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.",
"Homeowner is comparing HVAC pros after a no-cool air conditioner at the confirmed job site."
],
"description": "Always include this argument on every call — do not omit it (analytics / Agent Intent). Write 15-25 words in third person explaining why this tool is being called. Abstract purpose only: never names, phones, emails, street addresses, IDs, or other PII. Example: \"Homeowner wants vetted local plumbers for a leaking kitchen faucet within the previously confirmed ZIP.\""
},
"location": {
"type": "string",
"title": "Location",
"examples": [
"22307",
"94114"
],
"minLength": 1,
"description": "Prefer a 5-digit US ZIP for location (e.g. \"22307\" or \"94114\"). This is the primary and preferred location input. After get_my_profile, if address.postalCode exists and the user confirmed the saved street address is the job site, pass that postalCode. Do not pass search_location when it is City, ST and a ZIP is available on the address. Never pass a street address, formattedAddress, or address1."
}
}
}