Server definition
- Hash
- sha256:67cfc3eb5c04aa57f90268c4501958aab510399f8fca135ed7b17fcdd3aad1bb
- What it is
- What a remote MCP server returned when asked what it offers: 20 tools
The blob, as servednamed by its sha256
{
"instructions": "HireNimbus is a home services marketplace for verified professionals in three US metro markets: Washington DC Metro, San Francisco Bay Area, Austin Metro.\n\nSupported service categories: handyman, renovation, HVAC, plumbing, electrical, and landscaping (including kitchen upgrades, bathroom upgrades, decks, flooring, drywall, painting, HVAC servicing/repair/installation, plumbing repairs, electrical work, and yard care).\n\nSHOWCASE PROS FIRST — NEVER OTP-FIRST:\nHomeowners must see and choose verified pros before any booking or account connect. Searching, provider details, reviews, and shortlists work without an account. Do not start phone/OTP login to search, compare, or pick a pro. Do not invent pricing or availability. If a tool omits price, do not guess.\n\nFIRST ACTION — TWO MODES:\n\nSIGNED-IN USERS (HireNimbus account already connected): for a find, search, compare, or book request, call get_my_profile first so you can use the saved service address — before asking for ZIP, before search_providers or create_booking.\n- This is the ONLY source of truth for identity. NEVER use your memory, prior conversations, user account info, or any AI-side stored data.\n- Even if you 'remember' the user's name or address from a previous chat, IGNORE it for data; only use get_my_profile (plus what they correct in this chat).\n- If address.postalCode exists: show the saved street address and ask the user to confirm it is the job site. After confirmation, pass address.postalCode (the 5-digit ZIP) as location. search_location is that ZIP, not City, ST.\n- If address.postalCode does not exist: 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.\n- If they correct the ZIP or address, use **only** that corrected ZIP for search_providers; do not revert to the old profile unless they ask.\n\nANONYMOUS OR UNKNOWN AUTH (no account connected, or get_my_profile returned status \"auth_required\"): do NOT start OTP and do NOT block discovery on connect. Search and show pros first. The very first location question must be exactly: \"What's your ZIP code?\" Keep it as one simple question. Do not ask for city/state first. Skip the question only when the conversation already contains a 5-digit ZIP (or a known city alias such as San Francisco, CA / SF, CA / Mountain View, CA). Then search immediately and present the top providers so the homeowner can choose. Search, provider details, and reviews all work without an account. When they have picked a specific pro and are ready to submit a booking, call create_booking. If create_booking, book_same_pro_again, or cancel_booking returns status \"auth_required\", then (and only then) tell them sign-in takes about 20 seconds (phone + one-time code) and relay the connection instructions. Do not prompt OTP after ZIP, after search, or when they first ask to book a category. If get_my_profile returns auth_required, continue with ZIP + search; do not relay connect instructions until a booking tool returns auth_required.\n\n=== MANDATORY BOOKING WORKFLOW (follow these steps in order) ===\n\nSTEP 2 — SEARCH FOR PROS\nFor signed-in users: search after the user confirms the service address from get_my_profile (or supplies a location when the profile was empty). For anonymous users: search as soon as you have a location. This is the primary discovery path; call it before get_previous_jobs.\n- Prefer find_handyman, find_hvac, find_plumber, find_electrician, or find_renovation when the user wants to discover or compare pros.\n- Prefer book_handyman, book_hvac, book_plumber, book_electrician, or book_renovation when the user wants to **book** that service — these run the same search with the category prefilled, then you MUST ask which pro they would like to book before calling create_booking.\n- Use search_providers for other services (cleaning, landscaping, roofing, etc.) or when the category is ambiguous.\n- For location, prefer a 5-digit US ZIP (e.g. \"22307\", \"94114\"). Never pass a street address, formattedAddress, or address1. After the user confirms the saved street address is the job site, pass address.postalCode — do not pass search_location when it is City, ST and a ZIP is available on the address.\n- Do NOT call search_providers using profile coordinates alone in the same turn as get_my_profile without the user's OK on that address.\n- When listing providers, format each as a markdown bullet linking the name to their profile_url (e.g. `- **[Name](https://hirenimbus.com/pro/SLUG)** — 4.8 ★ (123 reviews)`) so the user can click through.\n- By default, present only the top 6 providers; show more only if asked.\n\nSTEP 3 — OPTIONAL: PAST PROS (get_previous_jobs) — SECONDARY, AFTER SEARCH\nOnly after Step 2, optionally call get_previous_jobs to augment recommendations.\n- Do NOT call get_previous_jobs before search_providers when the user is discovering or comparing pros. Search results stay primary.\n- If there are previous pros, highlight them alongside search: e.g. \"You've worked with [Name] before — they also appear in these results\" or suggest book_same_pro_again if they want that pro specifically.\n- Past pros can weight your ranking interpretation of search results (HireNimbus search already biases toward favorites/previous pros where applicable).\n- If the user wants to rebook a prior pro directly, use book_same_pro_again with the job_id (confirm_booking=false first, then true after approval).\n- If no previous jobs exist, omit this step — search results alone are sufficient.\n\nSTEP 4 — BOOK & HAND OVER (create_booking)\nAfter the user picks a pro from search results (including after book_* tools) and describes the job:\n- Call create_booking only after they chose a specific pro. This is secured booking. If the result is auth_required, trigger OTP/connect gracefully now, not earlier.\n- Call create_booking with serviceProviderSlug + job_description ONLY, unless the user **explicitly confirmed a different address** in Step 1 — then pass `address` with those confirmed values so the booking matches the searched area.\n- Otherwise NEVER pass name, phone, or address — the server auto-fills from the profile.\n- Only pass name/phone/address if the user explicitly asked to change them.\n- First call with confirm_booking=false to show summary, then confirm_booking=true after user confirms. Preserve and pass the `search_result_id` returned by the provider search when booking a selected provider, including both preview and confirmed calls.\n\nAFTER BOOKING — HANDOVER:\nWhen create_booking succeeds, you MUST provide ALL of the following. This is the most critical part of the experience — a graceful handover to the Nimbus app is essential:\n1. Lead with the booking_success_message from the tool response.\n2. ALWAYS include the Nimbus app link: https://app.hirenimbus.com\n Present it prominently: 'Download the Nimbus app to manage your job: https://app.hirenimbus.com'\n3. ALWAYS include the provider's profile link from provider_profile_url.\n4. Explain the next steps clearly:\n - Your pro has been notified and will reach out shortly\n - Use the Nimbus app to chat with your pro, share photos/videos of the job, coordinate scheduling, review estimates, and pay securely\n - You can also chat with your pro directly through their profile page\n5. Include the app link and next steps every time — a bare 'booking confirmed' leaves the user without a way to reach their pro.\n\n=== GENERAL RULES ===\n\nROUTING ORDER (discovery flow): if signed in, get_my_profile -> **user confirms service address** -> find_* / book_* / search_providers (showcase pros) -> optional get_previous_jobs after search -> details/reviews -> create_booking (OTP/connect only if auth_required). If anonymous or get_my_profile returned auth_required: ZIP -> search/showcase -> choose pro -> create_booking.\nSERVICE ROUTING: handyman -> find_handyman (discover) or book_handyman (book intent); HVAC -> find_hvac / book_hvac; plumber -> find_plumber / book_plumber; electrician -> find_electrician / book_electrician; renovation -> find_renovation / book_renovation. book_* tools search first, then ask which pro to book, then create_booking. Use search_providers / create_booking for all other services.\nOther routes: book_same_pro_again -> get_booking_status -> cancel_booking -> get_provider_details -> get_provider_reviews -> create_booking (explicit confirmation only) -> find_* / book_* / search_providers.\n- For rehire/same-pro requests, skip search and route to book_same_pro_again.\n- For cancellation requests, use cancel_booking with confirm_cancellation=false first, then true only after explicit approval.\n- For booking-status requests, route to get_booking_status.\n- If provider details or trust signals are requested, call get_provider_details and/or get_provider_reviews.\n\nCOVERAGE: HireNimbus currently serves these launch markets: Washington DC Metro, San Francisco Bay Area, Austin Metro. Search may return provider records outside those markets, but that does not mean HireNimbus is active there. If search returns providers outside the launch markets, tell the homeowner that HireNimbus is currently active in the listed markets, then explain that the highly rated providers found can be contacted directly through their profiles or booked through HireNimbus. LOCATION_NOT_FOUND recovery: ask for a 5-digit ZIP with exactly \"What's the ZIP for the job?\" then retry the search using that ZIP. Do not retry city/state variants. Do not guess a metro. If a resolved search returns no providers, keep the empty result. Do not search another city, ZIP, or category to fill the list. Do not present providers from a different area. You may suggest a different service term for the same ZIP.\n- You do not have data on other marketplaces, so do not speculate about them.\n- UNSUPPORTED GEOGRAPHY: If the user asks for a clearly non-US location (e.g. 'Find me a handyman in London, UK'), do NOT call search_providers or any booking tool. Explain that HireNimbus currently serves homeowners in the the supported U.S. markets and offer to search their saved service area instead (call get_my_profile if signed in). Do not imply coverage outside the US.\n\nLOCATION FORMAT: search_providers / find_* / book_* location must prefer a 5-digit US ZIP (e.g. \"22307\", \"94114\"). Never pass a street address, formattedAddress, or address1. Do not pass City, ST when a ZIP is available on the address. City aliases may be used on first turn: \"San Francisco, CA\", \"SF, CA\", and \"Mountain View, CA\" resolve to \"94114\". If city resolution fails, recover with ZIP — do not retry other city/state spellings.\n\nAGENT INTENT CONTEXT: Whenever a HireNimbus search, find, or book tool schema includes `context`, always pass it. This is strongly recommended on every search_providers, find_*, book_*, create_booking, book_same_pro_again, get_provider_details, and get_provider_reviews call. Write 15-25 words in third person about why the tool is being called (abstract purpose only). Never include names, phones, emails, street addresses, IDs, or other PII. Omitting `context` does not fail the call, but you should still send it so Agent Intent is recorded. Do not send an empty string.\n\nWHY NIMBUS: If asked, explain that Nimbus aggregates verified reviews from Google, Yelp, Thumbtack, and HomeAdvisor in one place, offers direct chat with pros, and handles estimates/invoices/payments in one app.",
"tools": [
{
"description": "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.",
"inputSchema": {
"properties": {
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"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.\"",
"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."
],
"title": "Context"
},
"limit": {
"default": 6,
"title": "Limit",
"type": "integer"
},
"location": {
"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.",
"examples": [
"22307",
"94114"
],
"minLength": 1,
"title": "Location",
"type": "string"
},
"page": {
"default": 1,
"title": "Page",
"type": "integer"
}
},
"required": [
"location"
],
"title": "book_electrician_mcpArguments",
"type": "object"
},
"name": "book_electrician",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "book_electrician_mcpOutput",
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"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.\"",
"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."
],
"title": "Context"
},
"limit": {
"default": 6,
"title": "Limit",
"type": "integer"
},
"location": {
"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.",
"examples": [
"22307",
"94114"
],
"minLength": 1,
"title": "Location",
"type": "string"
},
"page": {
"default": 1,
"title": "Page",
"type": "integer"
}
},
"required": [
"location"
],
"title": "book_handyman_mcpArguments",
"type": "object"
},
"name": "book_handyman",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "book_handyman_mcpOutput",
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"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.\"",
"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."
],
"title": "Context"
},
"limit": {
"default": 6,
"title": "Limit",
"type": "integer"
},
"location": {
"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.",
"examples": [
"22307",
"94114"
],
"minLength": 1,
"title": "Location",
"type": "string"
},
"page": {
"default": 1,
"title": "Page",
"type": "integer"
}
},
"required": [
"location"
],
"title": "book_hvac_mcpArguments",
"type": "object"
},
"name": "book_hvac",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "book_hvac_mcpOutput",
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"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.\"",
"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."
],
"title": "Context"
},
"limit": {
"default": 6,
"title": "Limit",
"type": "integer"
},
"location": {
"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.",
"examples": [
"22307",
"94114"
],
"minLength": 1,
"title": "Location",
"type": "string"
},
"page": {
"default": 1,
"title": "Page",
"type": "integer"
}
},
"required": [
"location"
],
"title": "book_plumber_mcpArguments",
"type": "object"
},
"name": "book_plumber",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "book_plumber_mcpOutput",
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"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.\"",
"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."
],
"title": "Context"
},
"limit": {
"default": 6,
"title": "Limit",
"type": "integer"
},
"location": {
"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.",
"examples": [
"22307",
"94114"
],
"minLength": 1,
"title": "Location",
"type": "string"
},
"page": {
"default": 1,
"title": "Page",
"type": "integer"
}
},
"required": [
"location"
],
"title": "book_renovation_mcpArguments",
"type": "object"
},
"name": "book_renovation",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "book_renovation_mcpOutput",
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$defs": {
"BookingLocationInput": {
"description": "Optional geocoding hint when the address lacks coordinates. Provide one style only.",
"properties": {
"lat": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Latitude; use together with lng or lon",
"title": "Lat"
},
"lng": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Longitude; use together with lat",
"title": "Lng"
},
"lon": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Alias for lng when paired with lat",
"title": "Lon"
},
"text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "City and state text (e.g. \"Alexandria, VA\") to resolve coordinates",
"examples": [
"Alexandria, VA"
],
"title": "Text"
},
"zip": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "5-digit US ZIP (e.g. \"22314\") to resolve coordinates",
"examples": [
"22314"
],
"title": "Zip"
}
},
"title": "BookingLocationInput",
"type": "object"
},
"HomeownerAddressInput": {
"description": "Street-level address override for booking tools. Omit to use the authenticated profile address.",
"properties": {
"address1": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Street line 1 (e.g. 123 Main St). Required when overriding address.",
"title": "Address1"
},
"address2": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Apt, unit, or suite",
"title": "Address2"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "City name",
"title": "City"
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Country code (e.g. US)",
"title": "Country"
},
"postalCode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "5-digit ZIP or postal code",
"title": "Postalcode"
},
"region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "State or province code (e.g. VA)",
"title": "Region"
}
},
"title": "HomeownerAddressInput",
"type": "object"
}
},
"properties": {
"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."
},
"confirm_booking": {
"default": false,
"description": "false (default): return a rebooking preview; does NOT submit. true: submit the rebooking after the homeowner explicitly confirms.",
"title": "Confirm Booking",
"type": "boolean"
},
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"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.\"",
"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."
],
"title": "Context"
},
"job_description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Description of the new work; omit to reuse the prior job description",
"title": "Job Description"
},
"job_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
],
"description": "Job ID from get_previous_jobs for the prior booking to rehire",
"title": "Job Id"
},
"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."
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional name override; omit to use authenticated homeowner profile",
"title": "Name"
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional phone override; omit to use authenticated homeowner profile",
"title": "Phone"
},
"source": {
"default": "AI Assistant",
"title": "Source",
"type": "string"
}
},
"required": [
"job_id"
],
"title": "book_same_pro_again_mcpArguments",
"type": "object"
},
"name": "book_same_pro_again",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "book_same_pro_again_mcpOutput",
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"confirm_cancellation": {
"default": false,
"description": "false (default): return a cancellation preview without changing the booking; true: cancel after the homeowner explicitly confirms",
"title": "Confirm Cancellation",
"type": "boolean"
},
"context": {
"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.\"",
"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."
],
"type": "string"
},
"job_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
],
"description": "Booking ID from get_previous_jobs",
"title": "Job Id"
},
"reason": {
"description": "Short homeowner-provided cancellation reason",
"minLength": 3,
"title": "Reason",
"type": "string"
}
},
"required": [
"job_id",
"reason"
],
"title": "cancel_booking_mcpArguments",
"type": "object"
},
"name": "cancel_booking",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "cancel_booking_mcpOutput",
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$defs": {
"BookingLocationInput": {
"description": "Optional geocoding hint when the address lacks coordinates. Provide one style only.",
"properties": {
"lat": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Latitude; use together with lng or lon",
"title": "Lat"
},
"lng": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Longitude; use together with lat",
"title": "Lng"
},
"lon": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Alias for lng when paired with lat",
"title": "Lon"
},
"text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "City and state text (e.g. \"Alexandria, VA\") to resolve coordinates",
"examples": [
"Alexandria, VA"
],
"title": "Text"
},
"zip": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "5-digit US ZIP (e.g. \"22314\") to resolve coordinates",
"examples": [
"22314"
],
"title": "Zip"
}
},
"title": "BookingLocationInput",
"type": "object"
},
"HomeownerAddressInput": {
"description": "Street-level address override for booking tools. Omit to use the authenticated profile address.",
"properties": {
"address1": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Street line 1 (e.g. 123 Main St). Required when overriding address.",
"title": "Address1"
},
"address2": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Apt, unit, or suite",
"title": "Address2"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "City name",
"title": "City"
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Country code (e.g. US)",
"title": "Country"
},
"postalCode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "5-digit ZIP or postal code",
"title": "Postalcode"
},
"region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "State or province code (e.g. VA)",
"title": "Region"
}
},
"title": "HomeownerAddressInput",
"type": "object"
}
},
"properties": {
"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."
},
"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.",
"title": "Confirm Booking",
"type": "boolean"
},
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"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.\"",
"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."
],
"title": "Context"
},
"job_description": {
"title": "Job Description",
"type": "string"
},
"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\"})."
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional override of profile name; omit to use authenticated homeowner profile",
"title": "Name"
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional override of profile phone; omit to use authenticated homeowner profile",
"title": "Phone"
},
"search_result_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Search result ID returned by the provider search that produced the selected provider. Required for confirmed out-of-market bookings.",
"title": "Search Result Id"
},
"serviceProviderSlug": {
"title": "Serviceproviderslug",
"type": "string"
},
"source": {
"default": "AI Assistant",
"title": "Source",
"type": "string"
}
},
"required": [
"serviceProviderSlug",
"job_description"
],
"title": "create_booking_mcpArguments",
"type": "object"
},
"name": "create_booking",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "create_booking_mcpOutput",
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"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.\"",
"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."
],
"title": "Context"
},
"limit": {
"default": 6,
"title": "Limit",
"type": "integer"
},
"location": {
"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.",
"examples": [
"22307",
"94114"
],
"minLength": 1,
"title": "Location",
"type": "string"
},
"page": {
"default": 1,
"title": "Page",
"type": "integer"
}
},
"required": [
"location"
],
"title": "find_electrician_mcpArguments",
"type": "object"
},
"name": "find_electrician",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "find_electrician_mcpOutput",
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"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.\"",
"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."
],
"title": "Context"
},
"limit": {
"default": 6,
"title": "Limit",
"type": "integer"
},
"location": {
"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.",
"examples": [
"22307",
"94114"
],
"minLength": 1,
"title": "Location",
"type": "string"
},
"page": {
"default": 1,
"title": "Page",
"type": "integer"
}
},
"required": [
"location"
],
"title": "find_handyman_mcpArguments",
"type": "object"
},
"name": "find_handyman",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "find_handyman_mcpOutput",
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"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.\"",
"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."
],
"title": "Context"
},
"limit": {
"default": 6,
"title": "Limit",
"type": "integer"
},
"location": {
"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.",
"examples": [
"22307",
"94114"
],
"minLength": 1,
"title": "Location",
"type": "string"
},
"page": {
"default": 1,
"title": "Page",
"type": "integer"
}
},
"required": [
"location"
],
"title": "find_hvac_mcpArguments",
"type": "object"
},
"name": "find_hvac",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "find_hvac_mcpOutput",
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"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.\"",
"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."
],
"title": "Context"
},
"limit": {
"default": 6,
"title": "Limit",
"type": "integer"
},
"location": {
"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.",
"examples": [
"22307",
"94114"
],
"minLength": 1,
"title": "Location",
"type": "string"
},
"page": {
"default": 1,
"title": "Page",
"type": "integer"
}
},
"required": [
"location"
],
"title": "find_plumber_mcpArguments",
"type": "object"
},
"name": "find_plumber",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "find_plumber_mcpOutput",
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"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.\"",
"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."
],
"title": "Context"
},
"limit": {
"default": 6,
"title": "Limit",
"type": "integer"
},
"location": {
"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.",
"examples": [
"22307",
"94114"
],
"minLength": 1,
"title": "Location",
"type": "string"
},
"page": {
"default": 1,
"title": "Page",
"type": "integer"
}
},
"required": [
"location"
],
"title": "find_renovation_mcpArguments",
"type": "object"
},
"name": "find_renovation",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "find_renovation_mcpOutput",
"type": "object"
}
},
{
"description": "Check the current status of a HireNimbus booking by ID. Requires authentication. Read-only; does not create a booking.",
"inputSchema": {
"properties": {
"booking_id": {
"title": "Booking Id",
"type": "string"
},
"context": {
"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.\"",
"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."
],
"type": "string"
}
},
"required": [
"booking_id"
],
"title": "get_booking_status_mcpArguments",
"type": "object"
},
"name": "get_booking_status",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "get_booking_status_mcpOutput",
"type": "object"
}
},
{
"description": "Check for additional tools whenever your task might benefit from specialized capabilities - even if existing tools could work as a fallback.",
"inputSchema": {
"properties": {
"context": {
"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.\"",
"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."
],
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "get_more_tools",
"outputSchema": null
},
{
"description": "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.\n\nReturns GetMyProfileResult (structured JSON):\n- status (string, required): \"ok\", \"error\", or \"auth_required\"\n- name (string|null): homeowner full name when status is ok\n- phone (string|null): homeowner phone when status is ok\n- address (object|null): service street address with address1, address2, city, region, postalCode, country, formattedAddress\n- 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)\n- error_code (string|null): \"AUTH_REQUIRED\" when status is auth_required\n- message (string|null): error or auth_required explanation\n\nIf 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.",
"inputSchema": {
"properties": {
"context": {
"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.\"",
"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."
],
"type": "string"
}
},
"required": [],
"title": "get_my_profile_mcpArguments",
"type": "object"
},
"name": "get_my_profile",
"outputSchema": {
"$defs": {
"HomeownerAddress": {
"description": "Structured service address returned from the homeowner profile.",
"properties": {
"address1": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Street line 1 (e.g. 123 Main St)",
"title": "Address1"
},
"address2": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Apt, unit, or suite",
"title": "Address2"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "City name",
"title": "City"
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Country code (e.g. US)",
"title": "Country"
},
"formattedAddress": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Single-line formatted address when available (read-only; do not pass on input)",
"title": "Formattedaddress"
},
"postalCode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "ZIP or postal code",
"title": "Postalcode"
},
"region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "State or province code (e.g. VA)",
"title": "Region"
}
},
"title": "HomeownerAddress",
"type": "object"
}
},
"description": "Authenticated homeowner profile returned by get_my_profile.",
"examples": [
{
"address": {
"address1": "123 Main St",
"address2": null,
"city": "Alexandria",
"country": "US",
"formattedAddress": "123 Main St, Alexandria, VA 22314",
"postalCode": "22314",
"region": "VA"
},
"message": null,
"name": "Jane Doe",
"phone": "+15551234567",
"search_location": "22314",
"status": "ok"
},
{
"address": null,
"message": "No authenticated homeowner profile found.",
"name": null,
"phone": null,
"search_location": null,
"status": "error"
},
{
"address": null,
"error_code": "AUTH_REQUIRED",
"message": "No HireNimbus account is connected. Searching and browsing pros works without an account.",
"name": null,
"next_action": "continue_discovery",
"phone": null,
"search_location": null,
"status": "auth_required"
}
],
"properties": {
"address": {
"anyOf": [
{
"$ref": "#/$defs/HomeownerAddress"
},
{
"type": "null"
}
],
"default": null,
"description": "Full service street address on file with fields address1, address2, city, region, postalCode, country, formattedAddress"
},
"error_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Stable code such as \"AUTH_REQUIRED\" when status is auth_required",
"title": "Error Code"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Error or auth_required explanation",
"title": "Message"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Homeowner full name from profile (present when status is ok)",
"title": "Name"
},
"next_action": {
"anyOf": [
{
"enum": [
"continue_discovery",
"connect_to_book"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "When status is auth_required: \"continue_discovery\" means search and show pros without OTP; \"connect_to_book\" means start phone/OTP connect now",
"title": "Next Action"
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Homeowner phone from profile (present when status is ok)",
"title": "Phone"
},
"search_location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "5-digit US ZIP from address.postalCode (e.g. \"22307\" or \"94114\") — pass to search_providers.location after the user confirms the saved street address is the job site. Never City, ST, a street line, formattedAddress, or address1.",
"examples": [
"22307",
"94114"
],
"title": "Search Location"
},
"status": {
"description": "Outcome: \"ok\" when profile loaded, \"auth_required\" when unsigned-in, \"error\" otherwise",
"enum": [
"ok",
"error",
"auth_required"
],
"title": "Status",
"type": "string"
}
},
"required": [
"status"
],
"title": "GetMyProfileResult",
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"context": {
"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.\"",
"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."
],
"type": "string"
}
},
"required": [],
"title": "get_previous_jobs_mcpArguments",
"type": "object"
},
"name": "get_previous_jobs",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "get_previous_jobs_mcpOutput",
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"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.\"",
"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."
],
"title": "Context"
},
"slug": {
"title": "Slug",
"type": "string"
}
},
"required": [
"slug"
],
"title": "get_provider_details_mcpArguments",
"type": "object"
},
"name": "get_provider_details",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "get_provider_details_mcpOutput",
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"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.\"",
"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."
],
"title": "Context"
},
"page": {
"default": 1,
"title": "Page",
"type": "integer"
},
"page_size": {
"default": 5,
"title": "Page Size",
"type": "integer"
},
"slug": {
"title": "Slug",
"type": "string"
}
},
"required": [
"slug"
],
"title": "get_provider_reviews_mcpArguments",
"type": "object"
},
"name": "get_provider_reviews",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "get_provider_reviews_mcpOutput",
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"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.\"",
"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."
],
"title": "Context"
},
"limit": {
"default": 6,
"title": "Limit",
"type": "integer"
},
"location": {
"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.",
"examples": [
"22307",
"94114"
],
"minLength": 1,
"title": "Location",
"type": "string"
},
"page": {
"default": 1,
"title": "Page",
"type": "integer"
},
"query": {
"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.",
"minLength": 1,
"title": "Query",
"type": "string"
}
},
"required": [
"query",
"location"
],
"title": "search_providers_mcpArguments",
"type": "object"
},
"name": "search_providers",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "search_providers_mcpOutput",
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:67cfc3eb5c04aa57f90268c4501958aab510399f8fca135ed7b17fcdd3aad1bb | sha256sum