HireNimbus home services MCP

Searches HireNimbus providers for an electrician or electrical work, including jobs 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. Does not require authentication. Inputs include a 5-digit US ZIP location, page, limit, and optional context. Returns provider records and resolved location. Read-only.

Searches HireNimbus providers for a handyman or general home repair pro, including jobs 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. Does not require authentication. Inputs include a 5-digit US ZIP location, page, limit, and optional context. Returns provider records and resolved location. Read-only.

Searches HireNimbus providers for HVAC heating, cooling, or AC service, including jobs 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. Does not require authentication. Inputs include a 5-digit US ZIP location, page, limit, and optional context. Returns provider records and resolved location. Read-only.

Searches HireNimbus providers for a plumber or plumbing repair, including jobs 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. Does not require authentication. Inputs include a 5-digit US ZIP location, page, limit, and optional context. Returns provider records and resolved location. Read-only.

Searches HireNimbus providers for a renovation or remodeling contractor, including jobs 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. Does not require authentication. Inputs include a 5-digit US ZIP location, page, limit, and optional context. Returns provider records and resolved location. Read-only.

Creates a service request for a provider associated with a prior job ID. Inputs include the job ID and optional work, profile, location, and confirmation values. Requires authentication. Unauthenticated requests return status "auth_required". confirm_booking=false returns a preview; confirm_booking=true submits the request. Confirmed submissions are not idempotent; repeated confirmed submissions create separate requests. Returns booking status, summary, identifiers, links, and notification statuses.

Cancels an authenticated homeowner booking identified by job ID. confirm_cancellation=false returns a preview; true submits the cancellation. The cancellation reason is delivered to the provider.

Creates a service request for a provider slug and job description. Optional inputs include profile overrides, location, search result identifier, and confirmation flag. Requires authentication. Unauthenticated requests return status "auth_required". confirm_booking=false returns a preview with status "confirmation_required"; confirm_booking=true submits the request. Confirmed submissions are not idempotent; repeated confirmed submissions create separate requests. Returns booking status, identifiers, links, and notification statuses.

Searches HireNimbus providers for an electrician or electrical work, including jobs 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. Does not require authentication. Inputs include a 5-digit US ZIP location, page, limit, and optional context. Returns provider records and resolved location. Read-only.

Searches HireNimbus providers for a handyman or general home repair pro, including jobs 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. Does not require authentication. Inputs include a 5-digit US ZIP location, page, limit, and optional context. Returns provider records and resolved location. Read-only.

Searches HireNimbus providers for HVAC heating, cooling, or AC service, including jobs 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. Does not require authentication. Inputs include a 5-digit US ZIP location, page, limit, and optional context. Returns provider records and resolved location. Read-only.

Searches HireNimbus providers for a plumber or plumbing repair, including jobs 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. Does not require authentication. Inputs include a 5-digit US ZIP location, page, limit, and optional context. Returns provider records and resolved location. Read-only.

Searches HireNimbus providers for a renovation or remodeling contractor, including jobs 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. Does not require authentication. Inputs include a 5-digit US ZIP location, page, limit, and optional context. Returns provider records and resolved location. Read-only.

Returns the current status of a HireNimbus booking by ID. Requires authentication. Read-only.

Returns the authenticated homeowner profile as structured JSON. Fields include status, name, phone, address, search_location, error_code, and message. Status values are "ok", "error", and "auth_required". search_location is a 5-digit ZIP from address.postalCode (e.g. "22307" or "94114").

Returns past and active jobs for the authenticated homeowner. Requires authentication. Read-only.

Fetches a HireNimbus provider profile by slug. Does not require authentication. Inputs include slug and optional context. Returns ratings, reviews, past work, services, and availability where available. Read-only.

Fetches reviews for a HireNimbus provider by slug. Does not require authentication. Inputs include slug, page, page size, and optional context. Returns review text, ratings, dates, and review sources where available. Read-only.

Searches providers by home service keyword and location. Does not require authentication. Inputs include query, 5-digit US ZIP location, page, limit, and optional context. Returns provider records, resolved location, market status, and a search result identifier. Read-only.