Title100/100
Import address list
The title clearly communicates the tool’s action and subject. Keep it concise.
Description98/100
Imports US postal recipients from pasted text, CSV or XLSX into a saved list. Checks required fields and US address format; USPS verification runs only when configured, and usps_checked reports whether it ran. Format checks do not confirm deliverability. Returns list_id, ready counts and row problems. An existing list_id appends recipients, up to 300. Not for email, non-US addresses or advertising to purchased or rented lists.
The description explains the capability, when to use it, and what to expect.
Inputs21/100
2 of 6 inputs have descriptions. Add descriptions to the missing inputs, including where to obtain IDs and how to supply values.
addresses_text
Addresses as pasted text or CSV. One recipient per line ("Name, Street, City, ST ZIP") or a CSV with a header row.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
address_file › download_url
Not provided
Missing description. Explain what this value means and how to supply it.
address_file › file_id
Not provided
Missing description. Explain what this value means and how to supply it.
address_file › mime_type
Not provided
Missing description. Explain what this value means and how to supply it.
address_file › file_name
Not provided
Missing description. Explain what this value means and how to supply it.
list_id
Existing list to append to.
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
Annotations100/100
All four behavior hints are declared.
{
"title": "Import address list",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}Output schema66/100
Describe the returned fields so an agent can interpret the result.
View output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"kind",
"list_id",
"total",
"ready",
"corrected_by_usps",
"needs_fixing",
"problems"
],
"properties": {
"kind": {
"type": "string",
"const": "list"
},
"ready": {
"type": "number"
},
"total": {
"type": "number"
},
"list_id": {
"type": "string"
},
"problems": {
"type": "array",
"items": {
"type": "object",
"required": [
"row",
"given",
"problem"
],
"properties": {
"row": {
"type": "number"
},
"given": {
"type": "string"
},
"problem": {
"type": "string"
}
},
"additionalProperties": false
}
},
"needs_fixing": {
"type": "number"
},
"usps_checked": {
"type": "boolean"
},
"corrected_by_usps": {
"type": "number"
},
"skipped_over_limit": {
"type": "number"
}
},
"additionalProperties": false
}