submit_listing
Submit a DFW service business to the dfwmetro.net verified directory. The business MUST be genuinely online-bookable: booking_url must point at a real scheduling flow (date/time picker or booking widget) — quote forms, contact forms, phone-only, and login-gated flows fail verification. You do not need to categorize it yourself: describe what the business does in 'description' and the trade is assigned automatically (send 'trade' only if you are sure of the category id). Find the business's real street address BEFORE submitting — check its website (footer/contact page) or the JSON-LD LocalBusiness block on its site or booking page — and send it as 'street_address': it drives the exact map pin. When the trade requires a state license (plumbing, electrical, HVAC, personal & specialty services), also send 'license_number' (e.g. 'TACLA40925C', 'TECL 12345', 'M-12345') — the server pre-checks the format and the human desk verifies it against the state registry. You may also send 'starting_price_cents' (integer cents, e.g. 8500 = $85.00, shown publicly as 'from $X') and 'price_note' (short qualifier, e.g. 'per visit'). Accepted submissions start as NOT_YET_VERIFIED and pass human review before going live.
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": {
"legal_name": "<legal_name>",
"city": "<city>",
"booking_url": "<booking_url>"
},
"name": "submit_listing"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dba | No | Trade/DBA name shown publicly. Defaults to legal_name. | |
| city | Yes | DFW city, e.g. 'Plano'. | |
| phone | No | The business's public phone number. The verification desk runs an automated phone pre-check on it. | |
| trade | No | OPTIONAL. Category id from https://dfwmetro.net/categories.json (e.g. 'plumbing', 'electrical', 'personal_specialty'). Pre-v2 ids (e.g. 'nail-salon') are accepted and stored as their v2 industry. If omitted, the server assigns the trade from your description — you do not need to get this right yourself. | |
| website | No | The business's main website URL — not the booking page (that is booking_url). The verification desk runs an automated website pre-check on it. | |
| zip_code | No | The business's ZIP code, e.g. '75024'. | |
| legal_name | Yes | Legal business name. | |
| price_note | No | OPTIONAL. Short qualifier shown next to the starting price, e.g. 'per visit', 'up to shoulder length'. | |
| booking_url | Yes | REQUIRED. Direct URL of the business's real online scheduling flow (date/time picker or booking widget). Generic contact/quote forms, phone-only, and login-gated flows fail verification — do not submit them. | |
| description | No | What the business DOES, in plain words (e.g. 'mobile piano tuning, in-home appointments'). Used to categorize the listing when trade is omitted, and shown to the verification desk. The more specific, the better the categorization. | |
| service_area | No | Defaults to 'DFW'. | |
| submitted_by | No | Agent identifier, e.g. 'agent:my-booking-bot'. Defaults to 'agent:unknown'. | |
| subcategories | No | Must match the trade's subcategory labels in categories.json. | |
| license_number | No | STRONGLY RECOMMENDED when the trade requires a state license (plumbing, electrical, HVAC, personal & specialty services). The trade's license number, e.g. 'TACLA40925C' (HVAC), 'TECL 12345' (electrical), 'M-12345' (plumbing). The server checks the format against the Texas pattern; the human desk verifies it against the state registry before VERIFIED. | |
| street_address | No | STRONGLY RECOMMENDED. The business's real street address, e.g. '2818 Satsuma Drive'. Find it on the business's website (footer / contact page) or in the JSON-LD LocalBusiness block on its site or booking page BEFORE submitting. It drives the exact map pin; without it the listing gets only a city-level dot. Not required — submissions without it are still accepted. | |
| years_in_business | No | How long the business has been operating, in whole years. | |
| license_type_detail | No | Free-text license detail, e.g. 'Master Plumber' or 'Class A ACR Contractor'. Shown to the verification desk alongside license_number. | |
| starting_price_cents | No | OPTIONAL. Starting price in cents, e.g. 8500 = $85.00. Shown publicly as 'from $X'. Omit when pricing varies too much to quote a starting point. |