Start a purchase
start_checkoutStart buying a mailing list of the matching homes: owner names and mailing addresses delivered as an Excel file plus a CSV. Returns a Stripe Checkout URL; the user opens it and pays there (this tool never handles card details). Minimum 1000 addresses ($349). Needs a Meadley Bros. API key. Members create keys in Profile and billing under Advanced integrations. Only call this when the user has clearly asked to buy.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"radiusMiles": "<radiusMiles>",
"trade": "<trade>",
"quantity": "<quantity>"
},
"name": "start_checkout"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Latitude of the center of the service area (alternative to zip) | |
| lng | No | Longitude of the center of the service area (alternative to zip) | |
| zip | No | Five-digit US ZIP code at the center of the service area. Easiest way to say where. Send this, OR city and state, OR lat and lng. | |
| city | No | City name at the center of the service area, with state. Alternative to zip. | |
| state | No | Two-letter state, required with city. | |
| trade | Yes | The contractor's trade. One of: tree-services, forestry-mulching, land-services, lawn-care, landscaping, hardscaping, roofing, pest-control, pool-services. For any other home or property service use generic-other. | |
| listName | No | Optional name for the list in the user's account | |
| quantity | Yes | Addresses to buy, 1000 minimum, up to the count | |
| cancelUrl | No | Optional https URL if the user cancels. Defaults to the Meadley Bros. buy page. | |
| successUrl | No | Optional https URL to send the user to after paying. Defaults to the Meadley Bros. thank-you page. | |
| radiusMiles | Yes | Service radius in miles, 0.5 to 50. A typical contractor uses 15 to 25. | |
| recipientMode | No | Who the mail is addressed to. "owner_property" (default for most trades) uses the owner's name and mails it to the property. "owner" uses the owner's name and mails it to the owner's own address, which reaches absentee and out-of-state landlords. "resident" addresses Current Resident at the property. Forestry mulching and land clearing default to "owner". Leave it out unless the user says what they want. | owner_property |