MCP 서버

HireAHelper Moving Services

com.hireahelper/mcp
비즈니스 및 운영 커머스 및 리테일 공개 · 연결 가능 MCP 2025-11-25

이 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.
입력 스키마
{'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.
입력 스키마
{'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.
입력 스키마
{'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.
입력 스키마
{'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.
입력 스키마
{'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.
입력 스키마
{'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.
입력 스키마
{'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.
입력 스키마
{'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.
입력 스키마
{'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).
입력 스키마
{'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.
입력 스키마
{'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.
입력 스키마
{'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.
입력 스키마
{'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).
입력 스키마
{'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.
입력 스키마
{'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.
입력 스키마
{'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.
입력 스키마
{'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.
읽기 전용 멱등성
입력 스키마
{'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.
입력 스키마
{'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.
입력 스키마
{'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.
입력 스키마
{'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).
입력 스키마
{'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.
입력 스키마
{'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.
읽기 전용 멱등성
입력 스키마
{'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.
읽기 전용 외부 접근 가능
입력 스키마
{'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.
읽기 전용 외부 접근 가능
입력 스키마
{'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.
입력 스키마
{'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.
입력 스키마
{'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.
입력 스키마
{'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.
입력 스키마
{'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."}}}
복구됨
get_quote_details
2026년 10월 5일 2:54 AM
복구됨
get_job_reschedule_request
2026년 10월 5일 2:54 AM
복구됨
get_order_details
2026년 10월 5일 2:54 AM
복구됨
transmit_lead
2026년 10월 5일 2:54 AM
복구됨
get_distance_between_zips
2026년 10월 5일 2:54 AM
복구됨
transmit_leads_bulk
2026년 10월 5일 2:54 AM
복구됨
create_job_reschedule_request
2026년 10월 5일 2:54 AM
복구됨
get_job_reschedule_availability
2026년 10월 5일 2:54 AM
복구됨
get_distance_between_zips_bulk
2026년 10월 5일 2:54 AM
복구됨
get_distance_between_coordinates
2026년 10월 5일 2:54 AM
복구됨
find_contact_by_phone_or_email
2026년 10월 5일 2:54 AM
복구됨
delete_job_reschedule_request
2026년 10월 5일 2:54 AM
복구됨
check_availability_for_lead
2026년 10월 5일 2:54 AM
복구됨
add_contact_note
2026년 10월 5일 2:54 AM
복구됨
book_labor_only_order
2026년 10월 5일 2:54 AM
복구됨
upsert_contact
2026년 10월 5일 2:54 AM
삭제됨
upsert_contact
2026년 9월 27일 2:52 AM
삭제됨
transmit_leads_bulk
2026년 9월 27일 2:52 AM
삭제됨
transmit_lead
2026년 9월 27일 2:52 AM
삭제됨
get_quote_details
2026년 9월 27일 2:52 AM
삭제됨
get_order_details
2026년 9월 27일 2:52 AM
삭제됨
get_job_reschedule_request
2026년 9월 27일 2:52 AM
삭제됨
get_job_reschedule_availability
2026년 9월 27일 2:52 AM
삭제됨
get_distance_between_zips_bulk
2026년 9월 27일 2:52 AM
삭제됨
get_distance_between_zips
2026년 9월 27일 2:52 AM
삭제됨
get_distance_between_coordinates
2026년 9월 27일 2:52 AM
삭제됨
find_contact_by_phone_or_email
2026년 9월 27일 2:52 AM
삭제됨
delete_job_reschedule_request
2026년 9월 27일 2:52 AM
삭제됨
create_job_reschedule_request
2026년 9월 27일 2:52 AM
삭제됨
check_availability_for_lead
2026년 9월 27일 2:52 AM