Contact Append Mcp Tool
contact_appendEnrich marketing contact records with mailing address, email, and phone for outreach and audience building
**Tips for Best Results:**
- Provide as many input fields as possible to improve match quality
- Use `indiv` match type when targeting a specific person
- Request one output type per call when optimizing for match quality (especially for phone outputs)
- Set `cfg_maxrecs` when more than one record is acceptableTool 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": {
"outputs": "<outputs>"
},
"name": "contact_append"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| zip | No | 5 digit ZIP code | |
| city | No | City name | |
| last | No | Person's last name | |
| No | Email address to enrich | ||
| first | No | Person's first name | |
| phone | No | 10 digit phone number without formatting | |
| state | No | Two-character state code (US) | |
| address | No | Street address (line 1) | |
| outputs | Yes | Types of contact data to return. Choose at least one output type | |
| address_2 | No | Apartment or unit number | |
| match_type | No | Match at household (hhld) or individual (indiv) level | hhld |
| cfg_maxrecs | No | Maximum number of records to return | |
| cfg_required | No | Comma or semi-colon separated response fields that must be populated for a record to be returned | |
| rcfg_max_emails | No | Maximum number of emails per record (use with email_multiple) | |
| rcfg_exclude_domains | No | Domains to exclude from alternate email results |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| results | No | Records returned by the Operations API. Record fields pass through unchanged. | |
| query_id | No | ||
| warnings | No | ||
| input_query | No | ||
| num_matches | No | Number of matching queries. | |
| num_results | No | Number of records returned. | |
| match_counts | No | Sparse match counts. An absent key means zero. |