MCP-Server
HireNimbus home services MCP
io.github.HireNimbus/home-services-mcp
Was dieses MCP kann
Finds, compares, and books verified local professionals for plumbing, HVAC, electrical, handyman, renovation, and other home services.
Funktionen
Tools
20
Tools
book_electrician
Book electrician
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.
Nur Lesen
Externer Zugriff
Idempotent
Eingabeschema
{'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': None, '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.'}}}
Ausgabeschema
{'type': 'object', 'title': 'book_electrician_mcpOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
book_handyman
Book handyman
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.
Nur Lesen
Externer Zugriff
Idempotent
Eingabeschema
{'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': None, '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.'}}}
Ausgabeschema
{'type': 'object', 'title': 'book_handyman_mcpOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
book_hvac
Book HVAC
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.
Nur Lesen
Externer Zugriff
Idempotent
Eingabeschema
{'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': None, '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.'}}}
Ausgabeschema
{'type': 'object', 'title': 'book_hvac_mcpOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
book_plumber
Book plumber
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.
Nur Lesen
Externer Zugriff
Idempotent
Eingabeschema
{'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': None, '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.'}}}
Ausgabeschema
{'type': 'object', 'title': 'book_plumber_mcpOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
book_renovation
Book renovation
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.
Nur Lesen
Externer Zugriff
Idempotent
Eingabeschema
{'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': None, '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.'}}}
Ausgabeschema
{'type': 'object', 'title': 'book_renovation_mcpOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
book_same_pro_again
Book same pro again
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.
Externer Zugriff
Eingabeschema
{'type': 'object', '$defs': {'BookingLocationInput': {'type': 'object', 'title': 'BookingLocationInput', 'properties': {'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Lat', 'default': None, 'description': 'Latitude; use together with lng or lon'}, 'lng': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Lng', 'default': None, 'description': 'Longitude; use together with lat'}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Lon', 'default': None, 'description': 'Alias for lng when paired with lat'}, 'zip': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Zip', 'default': None, 'examples': ['22314'], 'description': '5-digit US ZIP (e.g. "22314") to resolve coordinates'}, 'text': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Text', 'default': None, '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': None, 'description': 'City name'}, 'region': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Region', 'default': None, 'description': 'State or province code (e.g. VA)'}, 'country': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Country', 'default': None, 'description': 'Country code (e.g. US)'}, 'address1': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Address1', 'default': None, 'description': 'Street line 1 (e.g. 123 Main St). Required when overriding address.'}, 'address2': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Address2', 'default': None, 'description': 'Apt, unit, or suite'}, 'postalCode': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Postalcode', 'default': None, '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': None, 'description': 'Optional name override; omit to use authenticated homeowner profile'}, 'phone': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Phone', 'default': None, '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': None, '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': None, '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': None, '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': None, 'description': 'Description of the new work; omit to reuse the prior job description'}}}
Ausgabeschema
{'type': 'object', 'title': 'book_same_pro_again_mcpOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
cancel_booking
Cancel booking
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.
Destruktiv
Externer Zugriff
Idempotent
Eingabeschema
{'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'}}}
Ausgabeschema
{'type': 'object', 'title': 'cancel_booking_mcpOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
create_booking
Create booking
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.
Externer Zugriff
Eingabeschema
{'type': 'object', '$defs': {'BookingLocationInput': {'type': 'object', 'title': 'BookingLocationInput', 'properties': {'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Lat', 'default': None, 'description': 'Latitude; use together with lng or lon'}, 'lng': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Lng', 'default': None, 'description': 'Longitude; use together with lat'}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Lon', 'default': None, 'description': 'Alias for lng when paired with lat'}, 'zip': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Zip', 'default': None, 'examples': ['22314'], 'description': '5-digit US ZIP (e.g. "22314") to resolve coordinates'}, 'text': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Text', 'default': None, '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': None, 'description': 'City name'}, 'region': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Region', 'default': None, 'description': 'State or province code (e.g. VA)'}, 'country': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Country', 'default': None, 'description': 'Country code (e.g. US)'}, 'address1': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Address1', 'default': None, 'description': 'Street line 1 (e.g. 123 Main St). Required when overriding address.'}, 'address2': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Address2', 'default': None, 'description': 'Apt, unit, or suite'}, 'postalCode': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Postalcode', 'default': None, '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': None, 'description': 'Optional override of profile name; omit to use authenticated homeowner profile'}, 'phone': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Phone', 'default': None, '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': None, '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': None, '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': None, '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': None, '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'}}}
Ausgabeschema
{'type': 'object', 'title': 'create_booking_mcpOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
find_electrician
Find electrician
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.
Nur Lesen
Externer Zugriff
Idempotent
Eingabeschema
{'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': None, '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.'}}}
Ausgabeschema
{'type': 'object', 'title': 'find_electrician_mcpOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
find_handyman
Find handyman
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.
Nur Lesen
Externer Zugriff
Idempotent
Eingabeschema
{'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': None, '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.'}}}
Ausgabeschema
{'type': 'object', 'title': 'find_handyman_mcpOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
find_hvac
Find HVAC
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.
Nur Lesen
Externer Zugriff
Idempotent
Eingabeschema
{'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': None, '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.'}}}
Ausgabeschema
{'type': 'object', 'title': 'find_hvac_mcpOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
find_plumber
Find plumber
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.
Nur Lesen
Externer Zugriff
Idempotent
Eingabeschema
{'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': None, '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.'}}}
Ausgabeschema
{'type': 'object', 'title': 'find_plumber_mcpOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
find_renovation
Find renovation
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.
Nur Lesen
Externer Zugriff
Idempotent
Eingabeschema
{'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': None, '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.'}}}
Ausgabeschema
{'type': 'object', 'title': 'find_renovation_mcpOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
get_booking_status
Get booking status
Check the current status of a HireNimbus booking by ID. Requires authentication. Read-only; does not create a booking.
Nur Lesen
Idempotent
Eingabeschema
{'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'}}}
Ausgabeschema
{'type': 'object', 'title': 'get_booking_status_mcpOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
get_more_tools
Check for additional tools whenever your task might benefit from specialized capabilities - even if existing tools could work as a fallback.
Nur Lesen
Externer Zugriff
Idempotent
Eingabeschema
{'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."'}}}
get_my_profile
Get my profile
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.
Nur Lesen
Idempotent
Eingabeschema
{'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."'}}}
Ausgabeschema
{'type': 'object', '$defs': {'HomeownerAddress': {'type': 'object', 'title': 'HomeownerAddress', 'properties': {'city': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'City', 'default': None, 'description': 'City name'}, 'region': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Region', 'default': None, 'description': 'State or province code (e.g. VA)'}, 'country': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Country', 'default': None, 'description': 'Country code (e.g. US)'}, 'address1': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Address1', 'default': None, 'description': 'Street line 1 (e.g. 123 Main St)'}, 'address2': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Address2', 'default': None, 'description': 'Apt, unit, or suite'}, 'postalCode': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Postalcode', 'default': None, 'description': 'ZIP or postal code'}, 'formattedAddress': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Formattedaddress', 'default': None, 'description': 'Single-line formatted address when available (read-only; do not pass on input)'}}, 'description': 'Structured service address returned from the homeowner profile.'}}, 'title': 'GetMyProfileResult', 'examples': [{'name': 'Jane Doe', 'phone': '+15551234567', 'status': 'ok', 'address': {'city': 'Alexandria', 'region': 'VA', 'country': 'US', 'address1': '123 Main St', 'address2': None, 'postalCode': '22314', 'formattedAddress': '123 Main St, Alexandria, VA 22314'}, 'message': None, 'search_location': '22314'}, {'name': None, 'phone': None, 'status': 'error', 'address': None, 'message': 'No authenticated homeowner profile found.', 'search_location': None}, {'name': None, 'phone': None, 'status': 'auth_required', 'address': None, 'message': 'No HireNimbus account is connected. Searching and browsing pros works without an account.', 'error_code': 'AUTH_REQUIRED', 'next_action': 'continue_discovery', 'search_location': None}], 'required': ['status'], 'properties': {'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Name', 'default': None, 'description': 'Homeowner full name from profile (present when status is ok)'}, 'phone': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Phone', 'default': None, 'description': 'Homeowner phone from profile (present when status is ok)'}, 'status': {'enum': ['ok', 'error', 'auth_required'], 'type': 'string', 'title': 'Status', 'description': 'Outcome: "ok" when profile loaded, "auth_required" when unsigned-in, "error" otherwise'}, 'address': {'anyOf': [{'$ref': '#/$defs/HomeownerAddress'}, {'type': 'null'}], 'default': None, 'description': 'Full service street address on file with fields address1, address2, city, region, postalCode, country, formattedAddress'}, 'message': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Message', 'default': None, 'description': 'Error or auth_required explanation'}, 'error_code': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Error Code', 'default': None, 'description': 'Stable code such as "AUTH_REQUIRED" when status is auth_required'}, 'next_action': {'anyOf': [{'enum': ['continue_discovery', 'connect_to_book'], 'type': 'string'}, {'type': 'null'}], 'title': 'Next Action', 'default': None, 'description': 'When status is auth_required: "continue_discovery" means search and show pros without OTP; "connect_to_book" means start phone/OTP connect now'}, 'search_location': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Search Location', 'default': None, 'examples': ['22307', '94114'], '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.'}}, 'description': 'Authenticated homeowner profile returned by get_my_profile.'}
get_previous_jobs
Get previous jobs
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.
Nur Lesen
Idempotent
Eingabeschema
{'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."'}}}
Ausgabeschema
{'type': 'object', 'title': 'get_previous_jobs_mcpOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
get_provider_details
Get provider details
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.
Nur Lesen
Externer Zugriff
Idempotent
Eingabeschema
{'type': 'object', 'title': 'get_provider_details_mcpArguments', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'title': 'Slug'}, 'context': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Context', 'default': None, '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."'}}}
Ausgabeschema
{'type': 'object', 'title': 'get_provider_details_mcpOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
get_provider_reviews
Get provider reviews
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.
Nur Lesen
Externer Zugriff
Idempotent
Eingabeschema
{'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': None, '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}}}
Ausgabeschema
{'type': 'object', 'title': 'get_provider_reviews_mcpOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
search_providers
Search providers
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.
Nur Lesen
Externer Zugriff
Idempotent
Eingabeschema
{'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': None, '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.'}}}
Ausgabeschema
{'type': 'object', 'title': 'search_providers_mcpOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
Verlauf
Letzte Tool-Änderungen
Hinzugefügt
get_more_tools
17. September 2026 12:42
Hinzugefügt
book_renovation
17. September 2026 12:42
Hinzugefügt
find_renovation
17. September 2026 12:42
Hinzugefügt
book_electrician
17. September 2026 12:42
Hinzugefügt
find_electrician
17. September 2026 12:42
Hinzugefügt
book_plumber
17. September 2026 12:42
Hinzugefügt
find_plumber
17. September 2026 12:42
Hinzugefügt
book_hvac
17. September 2026 12:42
Hinzugefügt
find_hvac
17. September 2026 12:42
Hinzugefügt
book_handyman
17. September 2026 12:42
Hinzugefügt
find_handyman
17. September 2026 12:42
Hinzugefügt
cancel_booking
17. September 2026 12:42
Hinzugefügt
book_same_pro_again
17. September 2026 12:42
Hinzugefügt
get_booking_status
17. September 2026 12:42
Hinzugefügt
get_previous_jobs
17. September 2026 12:42
Hinzugefügt
create_booking
17. September 2026 12:42
Hinzugefügt
get_provider_reviews
17. September 2026 12:42
Hinzugefügt
get_provider_details
17. September 2026 12:42
Hinzugefügt
search_providers
17. September 2026 12:42
Hinzugefügt
get_my_profile
17. September 2026 12:42
Entdecken
Ähnliche MCP-Server
AgentLot Marketplace
io.agentlot/marketplace
Enables agents and users to discover, bid on, purchase, deliver, and settle paid digital services and compute work.
Obriym CRM
com.obriym-crm/mcp
Manages CRM records, sales pipelines, activities, orders, products, inventory, and marketplace catalog operations.
zobrx
com.zobrx/zobrx
Provides read-only ecommerce operations and analytics for orders, inventory, marketplace performance, advertising, settlements, t…
SupplySlate
com.supplyslate/sourcing
Supports component sourcing, fabrication requests, supplier RFQs, catalog imports, quotes, purchase planning, checkout handoffs, …
velora
com.somosvelora/velora
Provides Argentine commerce operations including catalog and inventory, customer and supplier management, cash register tracking,…
Shopify
io.github.pipeworx-io/shopify
Provides read access to Shopify Admin data for store operations through the Shopify REST API.
Woocommerce
io.github.pipeworx-io/woocommerce
Provides access to WooCommerce store data through the WooCommerce REST API.
Troostwijk
io.github.pipeworx-io/troostwijk
Searches European industrial and insolvency liquidation auctions and retrieves auction lot details.