Build a contact list
build_listBuys the list priced with quote_list: same filters and count, plus max_credits, the most the person agreed to spend. Reveals the businesses in order of record quality, never spends more than max_credits (businesses already revealed come free) and returns one row per business (WhatsApp with its wa.me link, mobile, phone, email, website, place, when the contact was last seen) plus a receipt: delivered, charged, free, how many have WhatsApp, credits per WhatsApp and credits left. Only businesses with at least one contact are listed; to pay only for WhatsApp, set channel: 'whatsapp'.
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": {
"count": "<count>",
"max_credits": "<max_credits>"
},
"name": "build_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Part of the business name | |
| count | Yes | How many businesses the list should have (max 200) | |
| place | No | Province, canton or district in Costa Rica (e.g. 'Escazú', 'La Fortuna', 'Heredia'); in Panama, province, district or corregimiento (e.g. 'Chiriquí', 'David', 'Bella Vista'); in Guatemala, department or municipality (e.g. 'Quetzaltenango', 'Mixco'); in the Dominican Republic, province or municipality (e.g. 'La Vega', 'Santo Domingo Este'). Accents optional | |
| social | No | Only businesses with this social profile | |
| booking | No | How they take bookings: through WhatsApp, without a booking system (phone, email, form) or with one. Known for about 1,500 businesses, mostly spas, salons and hotels | |
| channel | No | Only businesses with this contact (mobile: a mobile number published as a phone, likely WhatsApp) | |
| country | No | CR (Costa Rica, the default), PA (Panama), GT (Guatemala) or DO (Dominican Republic) | |
| website | No | none: no website (or it is down or parked); has: a working website | |
| ad_pixel | No | true: its own website has a Meta or TikTok ad pixel | |
| category | No | Category slug inside the industry, e.g. barberia, odontologia, pulperia_minisuper, taller_mecanico, hotel. list_categories has them all; an unknown one comes back with the valid ones | |
| industry | No | Industry slug, named in search_businesses and list_categories | |
| min_rooms | No | Hotels: at least this many rooms | |
| built_with | No | Only businesses whose own website is built with this CMS or site builder | |
| email_type | No | own_domain: email on the business's own domain; free: Gmail, Hotmail, Outlook, Yahoo, iCloud and similar | |
| max_credits | Yes | The most credits the person agreed to spend in this call | |
| online_store | No | true: its own website is an online store (Shopify, WooCommerce with products, PrestaShop…) | |
| outdated_site | No | true: its own website shows no update in two years or more (copyright year or page dates) | |
| independent_only | No | true: small businesses only, no chain locations | |
| min_whatsapp_confidence | No | Minimum WhatsApp confidence, 0 to 1 |