Servidor MCP

HireAHelper Moving Services

com.hireahelper/mcp
Negocio y operaciones Comercio y retail Público y accesible MCP 2025-11-25

Qué hace este MCP

Finds moving-service providers, checks coverage, estimates crew and labor needs, retrieves provider details and reviews, and creates or delivers quotes.

add_contact_note
Adds a note to an existing contact in the partner's CRM and returns the new contact-event id. WRITE ACTION: this modifies partner CRM data. Requires the numeric contactId (e.g. from upsert_contact or find_contact_by_phone_or_email). If the contact does not exist, a plain-text not-found message is returned instead of throwing.
Esquema de entrada
{'type': 'object', 'required': ['contactId', 'notes'], 'properties': {'notes': {'type': 'string', 'description': 'The content of the note.'}, 'contactId': {'type': 'integer', 'description': 'The numeric identifier of the contact to attach the note to.'}}}
book_labor_only_order
Creates and books a Labor-Only Order in the marketplace. THIS BOOKS A REAL MOVE. Same-day bookings are not allowed; next-day has restrictions. Returns the raw booking result.
Esquema de entrada
{'type': 'object', 'required': ['body'], 'properties': {'body': {'type': 'object', 'required': ['dateOfJob', 'typeOfHelpNeeded', 'primaryLocation', 'arrivalWindow', 'contactInformation'], 'properties': {'crewSize': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'jobNotes': {'type': ['string', 'null'], 'maxLength': 6000}, 'dateOfJob': {'type': 'string'}, 'laborHours': {'type': 'number', 'maximum': 50, 'minimum': 2}, 'arrivalWindow': {'type': 'string'}, 'customReference': {'type': ['string', 'null'], 'maxLength': 100}, 'primaryLocation': {'type': 'object', 'required': ['street', 'city', 'state', 'zip'], 'properties': {'zip': {'type': 'string'}, 'city': {'type': 'string'}, 'state': {'type': 'string'}, 'street': {'type': 'string'}, 'streetLineTwo': {'type': ['string', 'null']}, 'flightsOfStairs': {'type': 'integer'}}}, 'typeOfHelpNeeded': {'enum': ['Unknown', 'Loading', 'Unloading', 'LoadingAndUnloading', 'MoveOnSiteOnly'], 'type': 'string'}, 'workerLocationId': {'type': 'integer', 'maximum': 2147483647, 'minimum': 1}, 'billingInformation': {'type': ['object', 'null'], 'required': ['firstName', 'lastName', 'phoneNum', 'emailAddress', 'billingAddress'], 'properties': {'lastName': {'type': 'string'}, 'phoneNum': {'type': 'string'}, 'firstName': {'type': 'string'}, 'emailAddress': {'type': 'string'}, 'billingAddress': {'type': 'object', 'required': ['street', 'city', 'state', 'zip'], 'properties': {'zip': {'type': 'string', 'maxLength': 5, 'minLength': 5}, 'city': {'type': 'string', 'maxLength': 50, 'minLength': 1}, 'state': {'type': 'string', 'maxLength': 2, 'minLength': 1}, 'street': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'streetLineTwo': {'type': ['string', 'null'], 'maxLength': 50}}}, 'secondaryPhone': {'type': ['string', 'null']}}}, 'contactInformation': {'type': 'object', 'required': ['firstName', 'lastName', 'phoneNum', 'emailAddress'], 'properties': {'lastName': {'type': 'string'}, 'phoneNum': {'type': 'string'}, 'firstName': {'type': 'string'}, 'emailAddress': {'type': 'string'}, 'secondaryPhone': {'type': ['string', 'null']}}}, 'heavyItemsSixPlusQty': {'type': ['integer', 'null']}, 'heavyItemsUprightPianosQty': {'type': ['integer', 'null']}, 'heavyItemsBabyGrandPianosQty': {'type': ['integer', 'null']}, 'heavyItemsBetweenFourFiftyAndSixQty': {'type': ['integer', 'null']}, 'heavyItemsBetweenThreeAndFourFiftyQty': {'type': ['integer', 'null']}}, 'description': 'The labor-only order booking request body'}}}
check_availability_for_lead
Checks the realtime availability (day and arrival windows) for a given LeadId on a given job date.
Esquema de entrada
{'type': 'object', 'required': ['dateOfJob', 'leadId'], 'properties': {'leadId': {'type': 'integer', 'description': 'The LeadId to check availability for'}, 'dateOfJob': {'type': 'string', 'description': 'The date of the move, in en-US MM/DD/YYYY format'}}}
check_coverage
Checks whether moving-labor coverage is available in one or more United States ZIP codes. Returns which of the given ZIP codes are covered and which are not.
Esquema de entrada
{'type': 'object', 'required': ['zipCodes'], 'properties': {'zipCodes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'One or more 5-digit United States ZIP codes to check for coverage'}}}
create_job_reschedule_request
Initiates a customer request to change the date/time of a job. If the job is Waiting For Helper it may be changed immediately. Returns the raw result.
Esquema de entrada
{'type': 'object', 'required': ['jobId', 'body'], 'properties': {'body': {'type': 'object', 'required': ['requestedDate', 'requestedArrivalWindow', 'note'], 'properties': {'note': {'type': 'string'}, 'requestedDate': {'type': 'string'}, 'requestedArrivalWindow': {'type': 'string'}}, 'description': 'The reschedule request body (desired new date/time)'}, 'jobId': {'type': 'integer', 'description': 'The Job ID to create the reschedule request for'}}}
create_marketplace_lfs_quote
Saves an LFS (local full service) quote and returns the Quote Public Key, Grand Total, and Checkout URL based on the provider selected.
Esquema de entrada
{'type': 'object', 'required': ['body'], 'properties': {'body': {'type': 'object', 'required': ['origin', 'destination', 'requestedDate', 'desiredArrivalWindow', 'contactInformation'], 'properties': {'notes': {'type': ['string', 'null'], 'maxLength': 6000}, 'origin': {'type': 'object', 'required': ['street', 'city', 'state', 'zip'], 'properties': {'zip': {'type': 'string', 'maxLength': 5, 'minLength': 5}, 'city': {'type': 'string', 'maxLength': 50, 'minLength': 1}, 'state': {'type': 'string', 'maxLength': 2, 'minLength': 1}, 'street': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'bedrooms': {'type': ['integer', 'null'], 'maximum': 20, 'minimum': 0}, 'streetLineTwo': {'type': ['string', 'null'], 'maxLength': 50}, 'flightsOfStairs': {'type': ['integer', 'null'], 'maximum': 20, 'minimum': 0}}}, 'crewSize': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'heavyItems': {'type': ['array', 'null'], 'items': {'type': 'object', 'required': ['itemType'], 'properties': {'itemType': {'enum': ['Unknown', 'ItemBetweenThreeAndFourFifty', 'ItemBetweenFourFiftyAndSix', 'ItemsSixPlus', 'Pianos'], 'type': 'string'}, 'quantity': {'type': 'integer', 'maximum': 100, 'minimum': 1}}}}, 'laborHours': {'type': 'number', 'maximum': 50, 'minimum': 2}, 'destination': {'type': 'object', 'required': ['street', 'city', 'state', 'zip'], 'properties': {'zip': {'type': 'string', 'maxLength': 5, 'minLength': 5}, 'city': {'type': 'string', 'maxLength': 50, 'minLength': 1}, 'state': {'type': 'string', 'maxLength': 2, 'minLength': 1}, 'street': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'bedrooms': {'type': ['integer', 'null'], 'maximum': 20, 'minimum': 0}, 'streetLineTwo': {'type': ['string', 'null'], 'maxLength': 50}, 'flightsOfStairs': {'type': ['integer', 'null'], 'maximum': 20, 'minimum': 0}}}, 'requestedDate': {'type': 'string'}, 'customReference': {'type': ['string', 'null'], 'maxLength': 100}, 'transportOptionId': {'type': 'integer'}, 'contactInformation': {'type': 'object', 'required': ['emailAddress', 'phoneNumber', 'firstName', 'lastName'], 'properties': {'lastName': {'type': 'string', 'maxLength': 50}, 'firstName': {'type': 'string', 'maxLength': 50}, 'phoneNumber': {'type': 'string'}, 'emailAddress': {'type': 'string', 'maxLength': 300}, 'secondaryPhoneNumber': {'type': ['string', 'null']}}}, 'providerLocationId': {'type': 'integer', 'maximum': 2147483647, 'minimum': 1}, 'desiredArrivalWindow': {'type': 'string'}}, 'description': 'The LFS marketplace create-quote request body'}}}
create_marketplace_quote
Saves a quote and returns a marketplace Quote ID, for a specific provider. This tool BOOKS a provider -- it does not discover one. Before calling, call list_service_providers (needs only the move date and loading ZIP; optionally accepts labor hours, crew size, sort order, service type, flights of stairs, and resultFormat) to find available providers, then take the chosen provider's location id from that result and pass it as workerLocationID. The input schema marks workerLocationID as optional, but a marketplace quote cannot be created without it -- omitting it returns a 400 ("WorkerLocationID must be between 1 and 2147483647"). Takes the full create-quote request and returns the raw result.
Esquema de entrada
{'type': 'object', 'required': ['body'], 'properties': {'body': {'type': 'object', 'required': ['contactInformation', 'serviceType'], 'properties': {'load': {'type': ['object', 'null'], 'required': ['address', 'desiredArrivalWindow', 'requestedDate'], 'properties': {'notes': {'type': ['string', 'null'], 'maxLength': 6000}, 'address': {'type': 'object', 'required': ['street', 'city', 'state', 'zip'], 'properties': {'zip': {'type': 'string', 'maxLength': 5, 'minLength': 5}, 'city': {'type': 'string', 'maxLength': 50, 'minLength': 1}, 'state': {'type': 'string', 'maxLength': 2, 'minLength': 1}, 'street': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'streetLineTwo': {'type': ['string', 'null'], 'maxLength': 50}}}, 'crewSize': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'laborHours': {'type': 'number', 'maximum': 50, 'minimum': 2}, 'requestedDate': {'type': 'string'}, 'flightsOfStairs': {'type': ['integer', 'null'], 'maximum': 20, 'minimum': 0}, 'workerLocationID': {'type': ['integer', 'null'], 'maximum': 2147483647, 'minimum': 1}, 'desiredArrivalWindow': {'type': 'string'}}}, 'unload': {'type': ['object', 'null'], 'required': ['address', 'desiredArrivalWindow', 'requestedDate'], 'properties': {'notes': {'type': ['string', 'null'], 'maxLength': 6000}, 'address': {'$ref': '#/properties/body/properties/load/properties/address'}, 'crewSize': {'type': 'integer', 'maximum': 12, 'minimum': 1}, 'laborHours': {'type': 'number', 'maximum': 50, 'minimum': 2}, 'requestedDate': {'type': 'string'}, 'flightsOfStairs': {'type': ['integer', 'null'], 'maximum': 20, 'minimum': 0}, 'workerLocationID': {'type': ['integer', 'null'], 'maximum': 2147483647, 'minimum': 1}, 'desiredArrivalWindow': {'type': 'string'}}}, 'heavyItems': {'type': ['array', 'null'], 'items': {'type': 'object', 'required': ['itemType'], 'properties': {'itemType': {'enum': ['Unknown', 'ItemBetweenThreeAndFourFifty', 'ItemBetweenFourFiftyAndSix', 'ItemsSixPlus', 'Pianos'], 'type': 'string'}, 'quantity': {'type': 'integer', 'maximum': 100, 'minimum': 1}}}}, 'transports': {'type': ['object', 'null'], 'properties': {'areWeMovingContainer': {'type': ['boolean', 'null']}, 'areWeMovingRentalTruck': {'type': ['boolean', 'null']}, 'areWeMovingFreightTrailer': {'type': ['boolean', 'null']}}}, 'serviceType': {'enum': ['Unknown', 'Standard', 'Elite', 'MoversPlusTruck', 'Transport', 'HybridZS', 'Container', 'FreightTrailer', 'CarShipping', 'TruckRental', 'ManagedLaborHourly', 'ManagedLaborPlus', 'CorporateRelocation_LaborOnly', 'CorporateRelocation_LocalFullService'], 'type': 'string'}, 'customReference': {'type': ['string', 'null'], 'maxLength': 100}, 'contactInformation': {'type': 'object', 'required': ['emailAddress', 'phoneNumber', 'firstName', 'lastName'], 'properties': {'lastName': {'type': 'string', 'maxLength': 50}, 'firstName': {'type': 'string', 'maxLength': 50}, 'phoneNumber': {'type': 'string'}, 'emailAddress': {'type': 'string', 'maxLength': 300}, 'secondaryPhoneNumber': {'type': ['string', 'null']}}}}, 'description': 'The marketplace create-quote request body'}}}
delete_job_reschedule_request
Cancels (deletes) a pending reschedule request for a job. Returns the raw result.
Esquema de entrada
{'type': 'object', 'required': ['jobId'], 'properties': {'jobId': {'type': 'integer', 'description': 'The Job ID to delete the reschedule request for'}}}
find_contact_by_phone_or_email
Looks up an existing customer contact by phone number or email and returns the contact record along with their quotes and orders within a recent lookback window. At least one of phoneNumber or emailAddress must be supplied. If no matching contact is found, a plain-text "No matching contact found." message is returned instead of JSON; a JSON result with success=true and an empty jobs list means the contact exists but has no recent quote/order activity.
Esquema de entrada
{'type': 'object', 'properties': {'phoneNumber': {'type': ['string', 'null'], 'default': None, 'description': "The customer's phone number in digits-only en-US format (10 digits). Either this or emailAddress is required."}, 'emailAddress': {'type': ['string', 'null'], 'default': None, 'description': "The customer's email address. Either this or phoneNumber is required."}, 'searchPeriodDays': {'type': ['integer', 'null'], 'default': None, 'description': 'The number of days to look back for associated quotes and orders. Between 1 and 365. Defaults to 60 when omitted.'}}}
get_distance_between_coordinates
Calculates the driving distance and time between two geographic coordinates (latitude/longitude pairs).
Esquema de entrada
{'type': 'object', 'required': ['lat1', 'lon1', 'lat2', 'lon2'], 'properties': {'lat1': {'type': 'number', 'description': 'Latitude of the first location'}, 'lat2': {'type': 'number', 'description': 'Latitude of the second location'}, 'lon1': {'type': 'number', 'description': 'Longitude of the first location'}, 'lon2': {'type': 'number', 'description': 'Longitude of the second location'}}}
get_distance_between_zips
Gets the driving distance, straight-line ('crow flies') distance, and driving time between two United States ZIP codes. Useful for estimating a move from an origin ZIP to a destination ZIP.
Esquema de entrada
{'type': 'object', 'required': ['fromZipCode', 'toZipCode'], 'properties': {'toZipCode': {'type': 'string', 'description': 'The 5-digit destination (ending) United States ZIP code'}, 'fromZipCode': {'type': 'string', 'description': 'The 5-digit origin (starting) United States ZIP code'}}}
get_distance_between_zips_bulk
Calculates distances for many United States ZIP code pairs at once (bulk). Returns the raw result for every pair.
Esquema de entrada
{'type': 'object', 'required': ['body'], 'properties': {'body': {'type': 'object', 'required': ['myPoints'], 'properties': {'myPoints': {'type': 'array', 'items': {'type': 'object', 'required': ['zip1', 'zip2'], 'properties': {'zip1': {'type': 'string', 'maxLength': 5, 'minLength': 5}, 'zip2': {'type': 'string', 'maxLength': 5, 'minLength': 5}}}, 'minItems': 1}}, 'description': 'The bulk request containing the ZIP code pairs to calculate distances for'}}}
get_job_reschedule_availability
Gets the list of available dates and arrival windows for the provider on a job, for rescheduling.
Esquema de entrada
{'type': 'object', 'required': ['jobId'], 'properties': {'jobId': {'type': 'integer', 'description': 'The Job ID to look up rescheduling availability for'}}}
get_job_reschedule_request
Gets the latest reschedule status for a job (e.g. waiting for provider, successfully changed).
Esquema de entrada
{'type': 'object', 'required': ['jobId'], 'properties': {'jobId': {'type': 'integer', 'description': 'The Job ID to get reschedule details for'}}}
get_lfs_move_estimate
Calculates labor hours, crew size, and truck size range for a local full-service (LFS) move. Takes the full LFS estimator request and returns the raw result.
Esquema de entrada
{'type': 'object', 'required': ['body'], 'properties': {'body': {'type': 'object', 'required': ['originZip', 'destinationZip', 'originAddressType'], 'properties': {'originZip': {'type': 'string'}, 'destinationZip': {'type': 'string'}, 'originAddressType': {'enum': ['Unknown', 'House', 'CondoApt', 'Studio', 'Office', 'StorageUnit', 'Other', 'Castle'], 'type': 'string'}, 'originBedroomCount': {'type': ['integer', 'null']}}, 'description': 'The local full-service estimator request body'}}}
get_move_size_recommendation
Recommends how much moving help a job needs (suggested labor hours and crew size) for the load and unload locations, based on the size of the move. You MUST provide at least one of squareFeet or linearFeet to describe the size of the goods -- a call with neither is rejected. Also provide flights of stairs at each location. Optionally include counts of heavy items, which increase the recommended crew and hours.
Esquema de entrada
{'type': 'object', 'properties': {'pianosQty': {'type': ['integer', 'null'], 'default': None, 'description': 'Number of pianos'}, 'linearFeet': {'type': ['integer', 'null'], 'default': None, 'description': 'The linear feet (LFT) of the goods to be moved (5-56). Required unless squareFeet is provided; you must supply at least one of squareFeet or linearFeet.'}, 'squareFeet': {'type': ['integer', 'null'], 'default': None, 'description': 'The square feet of the goods to be moved (1-4000). Required unless linearFeet is provided; you must supply at least one of squareFeet or linearFeet.'}, 'loadFlightsOfStairs': {'type': ['integer', 'null'], 'default': None, 'description': 'Flights of stairs at the loading location (0-20)'}, 'heavyItems600PlusQty': {'type': ['integer', 'null'], 'default': None, 'description': 'Number of heavy items weighing over 600 lbs'}, 'heavyItems300To450Qty': {'type': ['integer', 'null'], 'default': None, 'description': 'Number of heavy items weighing between 300 and 450 lbs'}, 'heavyItems450To600Qty': {'type': ['integer', 'null'], 'default': None, 'description': 'Number of heavy items weighing between 450 and 600 lbs'}, 'unloadFlightsOfStairs': {'type': ['integer', 'null'], 'default': None, 'description': 'Flights of stairs at the unloading location (0-20)'}}}
get_order_details
Retrieves complete details for one or more Moves, based on OrderID(s). Returns the raw order details.
Esquema de entrada
{'type': 'object', 'required': ['body'], 'properties': {'body': {'type': 'object', 'required': ['orderIds'], 'properties': {'orderIds': {'type': 'array', 'items': {'type': 'integer'}, 'minItems': 1}}, 'description': 'The order-details request body (the OrderID(s) to look up)'}}}
get_permit_coverage
Checks PermitPuller coverage for a United States ZIP code: whether a truck permit, container permit, and/or construction permit (or their courtesy-posting alternatives) are available, plus the PermitPuller landing page to purchase a permit if one is offered. Permit coverage is open marketplace catalog info. If the ZIP is not covered, a plain-text not-found message is returned instead of a formatted result.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['zipCode'], 'properties': {'zipCode': {'type': 'string', 'description': 'The 5-digit United States ZIP code to check PermitPuller coverage for'}}}
get_provider_details
Gets detailed profile information for a specific moving provider location, including name, average review rating, years in business, total moves completed, equipment, credentials, and service coverage area (city, state, ZIP, and service radius). Requires a known providerId and providerLocationId. The average rating reported here is for this location only, not the provider overall -- see get_provider_reviews for the provider-wide review total.
Esquema de entrada
{'type': 'object', 'required': ['providerId', 'providerLocationId'], 'properties': {'providerId': {'type': 'integer', 'description': "The provider's unique identifier"}, 'serviceType': {'enum': ['Standard', 'Elite', 'MoversPlusTruck'], 'type': 'string', 'default': 'Standard', 'description': 'The service type to get details for (Standard, Elite, MoversPlusTruck)'}, 'providerLocationId': {'type': 'integer', 'description': "The provider location's unique identifier"}}}
get_provider_reviews
Gets customer reviews for a specific moving provider, newest first, paginated. For 'recent' or 'last N months' requests, compute the cutoff date yourself and pass it as startDate (yyyy-MM-dd): only reviews on/after that date are returned and the paging counts reflect the filtered set (a real server-side filter, not a sort). Each review includes rating, summary text, reviewer display name, move location, and date. The review total/count returned here is provider-wide -- aggregated across all of this provider's locations -- whereas list_service_providers and get_provider_details report a per-location review count/rating instead. Both figures are individually correct; they measure different scopes and must never be presented as contradictory.
Esquema de entrada
{'type': 'object', 'required': ['providerId'], 'properties': {'pageSize': {'type': ['integer', 'null'], 'default': None, 'description': 'The number of reviews per page (defaults to the API default)'}, 'startDate': {'type': ['string', 'null'], 'default': None, 'description': "Optional cutoff date (yyyy-MM-dd). Returns only reviews on/after this date. Compute it yourself for 'last N months' style requests. Omit for all reviews."}, 'pageNumber': {'type': ['integer', 'null'], 'default': None, 'description': 'The 1-based page number (defaults to the first page)'}, 'providerId': {'type': 'integer', 'description': "The provider's unique identifier"}}}
get_quote_completion_url
Gets the completion (checkout) URL for a specific quote by quote key, WITHOUT sending an email or SMS to the customer.
Esquema de entrada
{'type': 'object', 'required': ['quoteKey'], 'properties': {'quoteKey': {'type': 'string', 'format': 'uuid', 'description': 'The quote key (GUID)'}}}
get_quote_details
Gets details and status for a specific quote by its quote key (GUID).
Esquema de entrada
{'type': 'object', 'required': ['quoteKey'], 'properties': {'quoteKey': {'type': 'string', 'format': 'uuid', 'description': 'The quote key (GUID)'}}}
get_starting_price
Retrieves the 'starting at' price for moving labor services in a specific United States ZIP code. The returned price is a flat estimated starting total for the stated hours and crew size, not an hourly rate. Do NOT divide it by hours or by crew to derive a per-hour rate. For the true per-hour figure (extraHourRate) and a full pricing breakdown, call list_service_providers with resultFormat=Full.
Esquema de entrada
{'type': 'object', 'required': ['zipCode'], 'properties': {'zipCode': {'type': 'string', 'description': 'The 5-digit United States ZIP code'}}}
get_supported_service_types
Lists which moving-labor service types are supported in a 5-digit US ZIP code: labor-only (standard), labor-only (elite, background-checked crews), movers + truck (full service), and packing (an add-on to a labor booking). Use this to answer 'what moving service types do you have in my area'. This is a coverage/catalog answer (what is supported here), not a date-specific availability check -- for providers available on a given date use list_service_providers.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['zipCode'], 'properties': {'zipCode': {'type': 'string', 'description': 'The 5-digit US ZIP code to check supported service types for'}}}
list_service_providers
Lists moving-labor service providers serving a 5-digit US ZIP code on a given date, factoring in availability. This is the primary way to discover which providers serve an area. Resolve any city/state the user gives you to a single 5-digit ZIP yourself before calling; if the location is ambiguous, ask the user to confirm which ZIP. Results include providers that cannot currently be booked (canBook=false with reasonsCantShow) and are ordered per sortOrder: best price -> PriceLowToHigh, most expensive -> PriceHighToLow, best quality/highest rated -> QualityRating, most reviews -> MostReviewed, soonest available -> Availability, best match (marketplace default) -> BestMatch. When serviceType is MoversPlusTruck, unloadingZipCode (the destination ZIP) is required or the request is rejected by the Partner API. resultFormat controls the shape: Compact (default) returns a trimmed list where startingPrice is a flat estimated starting total for the quoted job size, not an hourly rate; Full returns the complete raw provider list and pricing breakdown. Interpreting pricing (labor-only / Standard): there is NO single "$X per hour" rate. Do NOT compute one by dividing price by hours, or by crew x hours. In the Compact (default) shape the only price field is startingPrice: present it as a flat estimated starting total for the job size you passed (laborHours/crewSize), and call again with resultFormat=Full when you need the per-hour breakdown. In the Full shape, price is a flat estimated starting total for actualNumHours hours with actualCrewSize crew -- it is not an hourly rate; the only true per-hour figure is extraHourRate (the cost of each additional hour of labor beyond the base). In the Full shape state pricing as: "$<price> for <actualCrewSize> movers for <actualNumHours> hours, plus $<extraHourRate>/hr for any additional time." Prefer serviceMiniDescription and publicNotices verbatim when present. Never present a single blended hourly rate. Review scope: in the Compact shape, reviewCount and averageRating -- and in the Full shape, the raw numberOfReviews and ratingAverage fields -- are for the single provider location serving the searched ZIP, not the provider overall. This per-location figure can legitimately differ from the provider-wide review total returned by get_provider_reviews; never present the two as contradictory.
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['loadingZipCode'], 'properties': {'crewSize': {'type': 'integer', 'default': 2, 'description': 'How many crew members should be sent. Defaults to 2.'}, 'sortOrder': {'enum': ['QualityRating', 'Availability', 'MostReviewed', 'PriceLowToHigh', 'PriceHighToLow', 'BestMatch'], 'type': 'string', 'default': 'BestMatch', 'description': 'The order to return providers in. Best price -> PriceLowToHigh, most expensive -> PriceHighToLow, best quality/highest rated -> QualityRating, most reviews -> MostReviewed, soonest available -> Availability, best match (marketplace default) -> BestMatch. Defaults to BestMatch.'}, 'laborHours': {'type': 'number', 'default': 2, 'description': 'The amount of labor hours needed (rounded to the nearest 15-minute increment). Defaults to 2.'}, 'maxResults': {'type': ['integer', 'null'], 'default': None, 'description': 'Maximum number of results to return (API minimum is 3, default all).'}, 'serviceType': {'enum': ['Standard', 'Elite', 'MoversPlusTruck'], 'type': 'string', 'default': 'Standard', 'description': 'The service type being requested (Standard, Elite, MoversPlusTruck). Defaults to Standard.'}, 'resultFormat': {'enum': ['Compact', 'Full'], 'type': 'string', 'default': 'Compact', 'description': 'Result shape: Compact (default) returns a trimmed provider list; Full returns the raw provider list including extraHourRate and the full pricing breakdown.'}, 'onlyAvailable': {'type': ['boolean', 'null'], 'default': None, 'description': 'Only return providers available for booking. Defaults to false (include all).'}, 'requestedDate': {'type': ['string', 'null'], 'default': None, 'description': 'Requested move date. Accepts ISO 8601 (yyyy-MM-dd) or en-US (M/d/yyyy); normalized internally. A specific move date is required -- collect and confirm the move date with the user before calling; there is no default date.'}, 'loadingZipCode': {'type': 'string', 'description': 'The 5-digit ZIP code of the loading (origin) location.'}, 'flightsOfStairs': {'type': 'integer', 'default': 0, 'description': 'Number of flights of stairs at the loading location. Defaults to 0.'}, 'unloadingZipCode': {'type': ['string', 'null'], 'default': None, 'description': 'The 5-digit ZIP code for the unload (destination) address. Required for Movers + Truck service type.'}}}
rank_best_providers
Ranks the moving providers available for a move and returns them in the order requested by sortOrder, each with its arrival windows. The caller chooses the ordering: best price -> PriceLowToHigh, most expensive -> PriceHighToLow, best quality / highest rated -> QualityRating, most reviews -> MostReviewed, soonest available -> Availability, best match / marketplace default -> BestMatch (the default when omitted). Providers that cannot be booked (no availability or no price) are returned separately in an 'excluded' list with the reason. Use this when the caller wants a recommendation rather than the full provider list. Pricing: each provider's price is a flat estimated starting total for the requested job (the laborHours and crewSize you passed), not an hourly rate. Do NOT divide it to derive a per-hour rate. For the true per-hour figure (extraHourRate) and a full pricing breakdown, call list_service_providers with resultFormat=Full.
Solo lectura Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['loadingZipCode', 'laborHours', 'crewSize', 'flightsOfStairs'], 'properties': {'crewSize': {'type': 'integer', 'description': 'How many crew members should be sent'}, 'sortOrder': {'enum': ['QualityRating', 'Availability', 'MostReviewed', 'PriceLowToHigh', 'PriceHighToLow', 'BestMatch'], 'type': 'string', 'default': 'BestMatch', 'description': 'The ordering to return providers in. Best price -> PriceLowToHigh, most expensive -> PriceHighToLow, best quality/highest rated -> QualityRating, most reviews -> MostReviewed, soonest available -> Availability, best match (marketplace default) -> BestMatch. Defaults to BestMatch.'}, 'laborHours': {'type': 'number', 'description': 'The amount of labor hours needed (rounded to the nearest 15-minute increment)'}, 'serviceType': {'enum': ['Standard', 'Elite', 'MoversPlusTruck'], 'type': 'string', 'default': 'Standard', 'description': 'The type of service being requested (Standard, Elite, MoversPlusTruck)'}, 'onlyAvailable': {'type': ['boolean', 'null'], 'default': None, 'description': 'Only consider providers available for booking. Defaults to false (include all)'}, 'requestedDate': {'type': ['string', 'null'], 'default': None, 'description': 'The date the move should take place. Accepts ISO 8601 (yyyy-MM-dd) or en-US (M/d/yyyy); normalized internally. A specific move date is required -- collect and confirm the move date with the user before calling; there is no default date.'}, 'loadingZipCode': {'type': 'string', 'description': 'The 5-digit ZIP code of the loading (origin) location'}, 'flightsOfStairs': {'type': 'integer', 'description': 'Number of flights of stairs at the loading location'}, 'unloadingZipCode': {'type': ['string', 'null'], 'default': None, 'description': 'The ZIP code for the unload (destination) address. Required for Movers + Truck service type'}}}
send_quote_completion_link
Sends a checkout/completion link to the customer for a specific quote (by quote key) via SMS and/or Email. THIS MESSAGES THE CUSTOMER.
Esquema de entrada
{'type': 'object', 'required': ['quoteKey', 'body'], 'properties': {'body': {'type': 'object', 'properties': {'sendSms': {'type': ['boolean', 'null']}, 'sendEmail': {'type': ['boolean', 'null']}}, 'description': 'Whether to send via email and/or SMS'}, 'quoteKey': {'type': 'string', 'format': 'uuid', 'description': 'The quote key (GUID)'}}}
transmit_lead
Securely transmits a lead contact's information to the marketplace. Requires an email address or phone number. Returns the raw result.
Esquema de entrada
{'type': 'object', 'required': ['body'], 'properties': {'body': {'type': 'object', 'properties': {'gclid': {'type': ['string', 'null']}, 'toCity': {'type': ['string', 'null']}, 'fromCity': {'type': ['string', 'null']}, 'lastName': {'type': ['string', 'null']}, 'toStreet': {'type': ['string', 'null']}, 'firstName': {'type': ['string', 'null']}, 'toZipCode': {'type': ['string', 'null']}, 'dateOfMove': {'type': ['string', 'null']}, 'fromStreet': {'type': ['string', 'null']}, 'addressType': {'enum': ['Unknown', 'House', 'CondoApt', 'Studio', 'Office', 'StorageUnit', 'Other', 'Castle', None], 'type': ['string', 'null']}, 'fromZipCode': {'type': ['string', 'null']}, 'phoneNumber': {'type': ['string', 'null']}, 'toStateAbbr': {'type': ['string', 'null']}, 'emailAddress': {'type': ['string', 'null']}, 'extraDetails': {'type': ['string', 'null']}, 'distanceMiles': {'type': ['integer', 'null']}, 'fromStateAbbr': {'type': ['string', 'null']}, 'subChannelKey': {'type': ['string', 'null']}, 'numberOfBedrooms': {'type': ['integer', 'null']}}, 'description': 'The lead information request body'}}}
transmit_leads_bulk
Securely transmits multiple lead contacts' information to the marketplace in bulk. Each item requires an email address or phone number. Returns the raw result.
Esquema de entrada
{'type': 'object', 'properties': {}}
upsert_contact
Creates or updates a Lead contact in the partner's CRM and returns the contact's id. WRITE ACTION: this modifies partner CRM data. At least one of phoneNumber or emailAddress must be supplied. An optional note can be included; the service saves it with the contact on a best-effort basis, so the upsert still succeeds even if the note cannot be saved.
Esquema de entrada
{'type': 'object', 'properties': {'notes': {'type': ['string', 'null'], 'default': None, 'description': 'Optional note to save with the contact. The service attaches it best-effort, so the upsert still succeeds even if the note cannot be saved.'}, 'lastName': {'type': ['string', 'null'], 'default': None, 'description': "The contact's last name."}, 'firstName': {'type': ['string', 'null'], 'default': None, 'description': "The contact's first name."}, 'companyName': {'type': ['string', 'null'], 'default': None, 'description': 'The company name, if applicable.'}, 'phoneNumber': {'type': ['string', 'null'], 'default': None, 'description': "The contact's phone number in digits-only en-US format (10 digits). Either this or emailAddress is required."}, 'emailAddress': {'type': ['string', 'null'], 'default': None, 'description': "The contact's email address. Either this or phoneNumber is required."}}}
Restaurado
get_quote_details
5 de October de 2026 a las 02:54
Restaurado
get_job_reschedule_request
5 de October de 2026 a las 02:54
Restaurado
get_order_details
5 de October de 2026 a las 02:54
Restaurado
transmit_lead
5 de October de 2026 a las 02:54
Restaurado
get_distance_between_zips
5 de October de 2026 a las 02:54
Restaurado
transmit_leads_bulk
5 de October de 2026 a las 02:54
Restaurado
create_job_reschedule_request
5 de October de 2026 a las 02:54
Restaurado
get_job_reschedule_availability
5 de October de 2026 a las 02:54
Restaurado
get_distance_between_zips_bulk
5 de October de 2026 a las 02:54
Restaurado
get_distance_between_coordinates
5 de October de 2026 a las 02:54
Restaurado
find_contact_by_phone_or_email
5 de October de 2026 a las 02:54
Restaurado
delete_job_reschedule_request
5 de October de 2026 a las 02:54
Restaurado
check_availability_for_lead
5 de October de 2026 a las 02:54
Restaurado
add_contact_note
5 de October de 2026 a las 02:54
Restaurado
book_labor_only_order
5 de October de 2026 a las 02:54
Restaurado
upsert_contact
5 de October de 2026 a las 02:54
Eliminado
upsert_contact
27 de September de 2026 a las 02:52
Eliminado
transmit_leads_bulk
27 de September de 2026 a las 02:52
Eliminado
transmit_lead
27 de September de 2026 a las 02:52
Eliminado
get_quote_details
27 de September de 2026 a las 02:52
Eliminado
get_order_details
27 de September de 2026 a las 02:52
Eliminado
get_job_reschedule_request
27 de September de 2026 a las 02:52
Eliminado
get_job_reschedule_availability
27 de September de 2026 a las 02:52
Eliminado
get_distance_between_zips_bulk
27 de September de 2026 a las 02:52
Eliminado
get_distance_between_zips
27 de September de 2026 a las 02:52
Eliminado
get_distance_between_coordinates
27 de September de 2026 a las 02:52
Eliminado
find_contact_by_phone_or_email
27 de September de 2026 a las 02:52
Eliminado
delete_job_reschedule_request
27 de September de 2026 a las 02:52
Eliminado
create_job_reschedule_request
27 de September de 2026 a las 02:52
Eliminado
check_availability_for_lead
27 de September de 2026 a las 02:52