Versium REACH

Create Job Mcp Tool

create_job

Create a listgen job, or a batch enrichment job over one of the user's lists.

For enrichment, run `setup_list` on the list first. Use `project_id` when possible. For charge-on-finish jobs, tell the user about usage and only submit `usage_consent_confirmed = true` after they consent. The `consent_required_job_types` meta field lists them; for contact_append it depends on `sub_jobs`.

Input Schema

Name	Required	Description
`name`	Yes	Output list name
`config`	Yes	Listgen: the exact input shape documented by `b2b_listgen_estimate` or `b2c_listgen_estimate`, without nesting or renaming fields; b2b_listgen requires `output`, b2c_listgen requires `required_fields`, max_records defaults to 10000 (max 50000). Enrichment: contact_append and demographic_append require `match_type` and `sub_jobs`; email_validation allows `include_alternate`; others take {}.
`job_type`	Yes	Enrichment types match the real-time tool names
`project_id`	No	Existing project for the output list
`project_name`	No	Project to find or create when there is no project_id
`input_list_id`	No	List to enrich (enrichment types)
`idempotency_key`	No	Reuse on retry; the same key and arguments return the original job
`usage_consent_confirmed`	No	True once the user consents to usage charges; required for charge-on-finish jobs

Output Schema

Name	Required	Description
`job_id`	No
`job_guid`	No
`job_state`	No
`list_name`	No
`project_id`	No
`job_operation`	No
`output_list_id`	No
`output_list_expires_at`	No	ISO-8601 expiration timestamp for the output list
`output_list_is_expired`	No	Whether the output list has expired

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 29, 2026

addedInput schema / properties / idempotency_key

Added value: +{
+  "description": "Reuse on retry; the same key and arguments return the original job",
+  "maxLength": 255,
+  "type": "string"
+}

Changed7 schema fields changedOct 28, 2026

changedInput schema / properties / config / description

Previous value: -"Nested job config using the exact input shape documented by `b2b_listgen_estimate` or `b2c_listgen_estimate` for the selected job_type, without nesting or renaming fields. b2b_listgen requires `output`. b2c_listgen requires `required_fields`. max_records defaults to 10000 and may not exceed 50000."New value: +"Listgen: the exact input shape documented by `b2b_listgen_estimate` or `b2c_listgen_estimate`, without nesting or renaming fields; b2b_listgen requires `output`, b2c_listgen requires `required_fields`, max_records defaults to 10000 (max 50000). Enrichment: contact_append and demographic_append require `match_type` and `sub_jobs`; email_validation allows `include_alternate`; others take {}."

addedInput schema / properties / input_list_id

Added value: +{
+  "description": "List to enrich (enrichment types)",
+  "minimum": 1,
+  "type": "integer"
+}

changedInput schema / properties / job_type / description

Previous value: -"Selects the internal operation branch for the nested config payload"New value: +"Enrichment types match the real-time tool names"

changedInput schema / properties / job_type / enum

Previous value: -[
-  "b2b_listgen",
-  "b2c_listgen"
-]New value: +[
+  "b2b_listgen",
+  "b2c_listgen",
+  "contact_append",
+  "b2b2c_append",
+  "c2b_append",
+  "demographic_append",
+  "firmographic_append",
+  "ip_to_domain_append",
+  "email_validation"
+]

changedInput schema / properties / project_id / description

Previous value: -"Preferred project target when the user already has a project"New value: +"Existing project for the output list"

changedInput schema / properties / project_name / description

Previous value: -"Fallback project name when the user wants MCP to create/find the project"New value: +"Project to find or create when there is no project_id"

changedInput schema / properties / usage_consent_confirmed / description

Previous value: -"Set to true to confirm the user has consented to usage charges. Required for job types that bill upon completion."New value: +"True once the user consents to usage charges; required for charge-on-finish jobs"

Changed2 schema fields changedSep 9, 2026

addedOutput schema / properties / output_list_expires_at

Added value: +{
+  "description": "ISO-8601 expiration timestamp for the output list",
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / properties / output_list_is_expired

Added value: +{
+  "description": "Whether the output list has expired",
+  "type": [
+    "boolean",
+    "null"
+  ]
+}

Changed4 schema fields changedAug 20, 2026

removedInput schema / properties / config / additionalProperties
```
Removed value: -false
```

changedInput schema / properties / config / description

Previous value: -"Nested job config. Supply fields matching the selected job_type. b2b_listgen requires `output`. b2c_listgen requires `required_fields`. max_records defaults to 10000 and may not exceed 50000."New value: +"Nested job config using the exact input shape documented by `b2b_listgen_estimate` or `b2c_listgen_estimate` for the selected job_type, without nesting or renaming fields. b2b_listgen requires `output`. b2c_listgen requires `required_fields`. max_records defaults to 10000 and may not exceed 50000."

removedInput schema / properties / config / properties

Removed value: -{
-  "cfg_b2cloc": {
-    "description": "Whether location filters apply to business location (0) or employee home location (1)",
-    "enum": [
-      0,
-      1
-    ],
-    "type": "integer"
-  },
-  "cfg_require_address": {
-    "description": "Set to true to require mailing addresses in the output",
-    "type": "boolean"
-  },
-  "cfg_require_email": {
-    "description": "Set to true to require email addresses in the output",
-    "type": "boolean"
-  },
-  "cfg_require_name": {
-    "description": "Set to true to require full names in the output",
-    "type": "boolean"
-  },
-  "cfg_require_phone": {
-    "description": "Set to true to require phone numbers in the output",
-    "type": "boolean"
-  },
-  "cfg_zipradius": {
-    "description": "Radius expansion (pseudo-miles) applied around supplied ZIP or city/state centers",
-    "minimum": 0,
-    "type": "number"
-  },
-  "cfg_zipradius_focus": {
-    "description": "Limits radius expansion to ZIP, city/state, or none",
-    "enum": [
-      "zip",
-      "citystate",
-      "none"
-    ],
-    "type": "string"
-  },
-  "contacts_per_addr": {
-    "description": "Maximum contacts per street address (0=unlimited, 1=one contact per address)",
-    "minimum": 0,
-    "type": "integer"
-  },
-  "d_age": {
-    "description": "Age range in years (single value or min-max, e.g., \"35-45\")",
-    "pattern": "^\\d{1,3}(-\\d{1,3})?$",
-    "type": "string"
-  },
-  "d_apparel_mens": {
-    "description": "Set to \"Y\" to include households associated with men's apparel interest.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_apparel_womens": {
-    "description": "Set to \"Y\" to include households associated with women's apparel interest.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_auto_makemodel": {
-    "description": "Auto make and model combo(s) (e.g. \"Ford:Escape\")",
-    "items": {
-      "pattern": "^[^:]+[:][^:]+$",
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "d_auto_year": {
-    "description": "Automobile year range (single year or min-max)",
-    "pattern": "^\\d{4}(-\\d{4})?$",
-    "type": "string"
-  },
-  "d_cardholder_bank": {
-    "description": "Set to \"Y\" to include households associated with bank card ownership.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_cardholder_upscale": {
-    "description": "Set to \"Y\" to include households associated with upscale card ownership.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_city_state": {
-    "description": "Array of city,state combinations (e.g., \"Seattle, WA\")",
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "d_county": {
-    "description": "County filters. For b2b_listgen use full county names. For b2c_listgen use county,state combinations (for example, \"King, WA\").",
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "d_creditlines": {
-    "description": "Number of credit lines range (e.g. \"0-5\")",
-    "pattern": "^\\d-\\d$",
-    "type": "string"
-  },
-  "d_creditrating": {
-    "description": "Credit rating range. See values in options tool",
-    "pattern": "^[A-H](-[A-H])?$",
-    "type": "string"
-  },
-  "d_donation_animals": {
-    "description": "Set to \"Y\" to include households associated with animal welfare donors.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_donation_arts_culture": {
-    "description": "Set to \"Y\" to include households associated with arts and culture donors.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_donation_children": {
-    "description": "Set to \"Y\" to include households associated with children's causes donors.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_donation_community": {
-    "description": "Set to \"Y\" to include households associated with community organization donors.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_donation_env": {
-    "description": "Set to \"Y\" to include households associated with environmental donors.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_donation_env_wildlife": {
-    "description": "Set to \"Y\" to include households associated with environmental or wildlife donors.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_donation_health": {
-    "description": "Set to \"Y\" to include households associated with health-related donors.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_donation_intl_aid": {
-    "description": "Set to \"Y\" to include households associated with international aid donors.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_donation_political": {
-    "description": "Set to \"Y\" to include households associated with general political donors.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_donation_political_conservative": {
-    "description": "Set to \"Y\" to include households associated with conservative political donors.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_donation_political_liberal": {
-    "description": "Set to \"Y\" to include households associated with liberal political donors.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_donation_religion": {
-    "description": "Set to \"Y\" to include households associated with religious donors.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_donation_unspecified": {
-    "description": "Set to \"Y\" to include households associated with unspecified cause donors.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_donation_veterans": {
-    "description": "Set to \"Y\" to include households associated with veteran support donors.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_dwellingtype": {
-    "description": "Dwelling type codes (M=Multi Family, S=Single Family, U=Unknown)",
-    "enum": [
-      "M",
-      "S",
-      "U"
-    ],
-    "type": "string"
-  },
-  "d_education": {
-    "description": "Education level codes: A=High School, B=College, C=Graduate, D=Technical/Vocational",
-    "items": {
-      "enum": [
-        "A",
-        "B",
-        "C",
-        "D"
-      ],
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "d_electronics": {
-    "description": "Set to \"Y\" to include households associated with consumer electronics interest.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_esthhldincome": {
-    "description": "Estimated household income range using codes. See values in options tool",
-    "pattern": "^[A-S](-[A-S])?$",
-    "type": "string"
-  },
-  "d_ethnicgroup": {
-    "description": "Ethnic group codes. See values in options tool",
-    "items": {
-      "pattern": "^[A-Z]$",
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "d_exercise": {
-    "description": "Set to \"Y\" to include households associated with fitness and exercise interest.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_fishing": {
-    "description": "Set to \"Y\" to include households associated with fishing interest.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_gardening": {
-    "description": "Set to \"Y\" to include households associated with gardening interest.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_gender": {
-    "description": "Gender filter (M=Male, F=Female)",
-    "enum": [
-      "M",
-      "F"
-    ],
-    "type": "string"
-  },
-  "d_golf": {
-    "description": "Set to \"Y\" to include households associated with golf interest.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_hhldveteran": {
-    "description": "Set to \"Y\" to include households associated with veteran households.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_home_improvement": {
-    "description": "Set to \"Y\" to include households associated with home improvement interest.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_home_market_value": {
-    "description": "Home market value range. See values in options tool",
-    "pattern": "^[A-S](-[A-S])?$",
-    "type": "string"
-  },
-  "d_home_purchase_date": {
-    "description": "Home purchase date in YYYYMMDD format",
-    "pattern": "^\\d{8}$",
-    "type": "string"
-  },
-  "d_home_purchase_price": {
-    "description": "Home purchase price in thousands",
-    "enum": [
-      "1",
-      "50",
-      "100",
-      "150",
-      "200",
-      "250",
-      "300",
-      "400",
-      "500",
-      "600",
-      "700",
-      "800",
-      "900",
-      "1000",
-      "1100",
-      "1200",
-      "1300",
-      "1400",
-      "1500",
-      "1600",
-      "1700",
-      "1800",
-      "1900",
-      "2000"
-    ],
-    "type": "string"
-  },
-  "d_home_value": {
-    "description": "Home value range. See values in options tool",
-    "pattern": "^[A-S](-[A-S])?$",
-    "type": "string"
-  },
-  "d_home_year": {
-    "description": "Year home was built (single year or range)",
-    "pattern": "^\\d{4}(-\\d{4})?$",
-    "type": "string"
-  },
-  "d_hunting": {
-    "description": "Set to \"Y\" to include households associated with hunting interest.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_investing_active": {
-    "description": "Set to \"Y\" to include households associated with active investing interest.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_language": {
-    "description": "Language codes. See values in options tool",
-    "items": {
-      "pattern": "^[A-Z0-9]{2}$",
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "d_lifestyle_antiques": {
-    "description": "Set to \"Y\" to include households associated with antiques interest.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_lifestyle_arts_general": {
-    "description": "Set to \"Y\" to include households associated with arts interest.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_lifestyle_cooking": {
-    "description": "Set to \"Y\" to include households associated with cooking interest.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_lifestyle_decorating": {
-    "description": "Set to \"Y\" to include households associated with decorating interest.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_lifestyle_health_beauty": {
-    "description": "Set to \"Y\" to include households associated with health and beauty interest.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_lifestyle_music": {
-    "description": "Set to \"Y\" to include households associated with music interest.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_lifestyle_outdoor": {
-    "description": "Set to \"Y\" to include households associated with outdoor recreation interest.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_lifestyle_reading": {
-    "description": "Set to \"Y\" to include households associated with reading interest.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_lifestyle_sports": {
-    "description": "Set to \"Y\" to include households associated with general sports interest.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_loantovalue": {
-    "description": "Loan-to-value percentage as single value or range (0-100)",
-    "pattern": "^\\d{1,3}(-\\d{1,3})?$",
-    "type": "string"
-  },
-  "d_lor": {
-    "description": "Length of residence in years (single value or range)",
-    "pattern": "^\\d{1,3}(-\\d{1,3})?$",
-    "type": "string"
-  },
-  "d_magazines": {
-    "description": "Set to \"Y\" to include households associated with magazine subscriptions.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_mailorderbuyer": {
-    "description": "Set to \"Y\" to include households associated with mail order purchasing activity.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_maritalstatus": {
-    "description": "Marital status codes (M=Married, S=Single, A=Married (Inferred), B=Single (Inferred))",
-    "items": {
-      "enum": [
-        "M",
-        "S",
-        "A",
-        "B"
-      ],
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "d_military_history": {
-    "description": "Set to \"Y\" to include households associated with military history households.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_mortgage2_amount": {
-    "description": "Second mortgage amount in thousands",
-    "enum": [
-      "1",
-      "50",
-      "100",
-      "150",
-      "200",
-      "250",
-      "300",
-      "400",
-      "500",
-      "600",
-      "700",
-      "800",
-      "900",
-      "1000"
-    ],
-    "type": "string"
-  },
-  "d_mortgage2_date": {
-    "description": "Second mortgage date in YYYYMMDD format",
-    "pattern": "^\\d{8}$",
-    "type": "string"
-  },
-  "d_mortgage2_loan_type": {
-    "description": "Second mortgage loan type codes. See values in options tool",
-    "enum": [
-      "5",
-      "C",
-      "F",
-      "P",
-      "S",
-      "V",
-      "W"
-    ],
-    "type": "string"
-  },
-  "d_mortgage2_rate": {
-    "description": "Second mortgage interest rate percentage",
-    "pattern": "^\\d{1,2}(\\.\\d{1,2})?%$",
-    "type": "string"
-  },
-  "d_mortgage2_rate_type": {
-    "description": "Second mortgage rate type codes. A=Adjustable, B=Balloon, F=Fixed, U=Unknown",
-    "enum": [
-      "A",
-      "B",
-      "F",
-      "U"
-    ],
-    "type": "string"
-  },
-  "d_mortgage_amount": {
-    "description": "Mortgage amount in thousands (use values like \"50\" or \"400\")",
-    "enum": [
-      "1",
-      "50",
-      "100",
-      "150",
-      "200",
-      "250",
-      "300",
-      "400",
-      "500",
-      "600",
-      "700",
-      "800",
-      "900",
-      "1000"
-    ],
-    "type": "string"
-  },
-  "d_mortgage_purchase_date": {
-    "description": "Mortgage purchase date in YYYYMMDD format",
-    "pattern": "^\\d{8}$",
-    "type": "string"
-  },
-  "d_mortgage_purchase_loan_type_code": {
-    "description": "Mortgage purchase loan type codes. See values in options tool",
-    "enum": [
-      "5",
-      "C",
-      "F",
-      "P",
-      "S",
-      "V",
-      "W"
-    ],
-    "type": "string"
-  },
-  "d_mortgage_rate": {
-    "description": "Mortgage interest rate percentage (e.g., \"6.75%\", \"10%\")",
-    "pattern": "^\\d{1,2}(\\.\\d{1,2})?%$",
-    "type": "string"
-  },
-  "d_mortgage_rate_type": {
-    "description": "Mortgage rate type codes. A=Adjustable, B=Balloon, F=Fixed, U=Unknown",
-    "enum": [
-      "A",
-      "B",
-      "F",
-      "U"
-    ],
-    "type": "string"
-  },
-  "d_motorcycles": {
-    "description": "Set to \"Y\" to include households associated with motorcycle interest.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_naics": {
-    "description": "Raw 2- to 6-digit NAICS codes. Use the options tool to retrieve valid values",
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "d_networth": {
-    "description": "Estimated net worth range using codes. See values in options tool",
-    "pattern": "^[A-I](-[A-I])?$",
-    "type": "string"
-  },
-  "d_news": {
-    "description": "Set to \"Y\" to include households associated with current affairs engagement.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_num_children": {
-    "description": "Number of children range (0-8, e.g., \"2-3\")",
-    "pattern": "^[0-9](-[0-9])?$",
-    "type": "string"
-  },
-  "d_numemployees": {
-    "description": "Company size range, in the format \"min-max\" (e.g. \"100-50000\")",
-    "type": "string"
-  },
-  "d_occupation": {
-    "description": "Occupation codes. See values in options tool",
-    "items": {
-      "pattern": "^[A-Z]$",
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "d_onlinepurchaser": {
-    "description": "Set to \"Y\" to include households associated with online purchasing activity.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_ownrent": {
-    "description": "Home ownership status codes (H=Owner, R=Renter, 9=Probable Owner)",
-    "items": {
-      "enum": [
-        "H",
-        "R",
-        "9"
-      ],
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "d_pets": {
-    "description": "Set to \"Y\" to include households associated with pet ownership.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_political_party": {
-    "description": "Political party affiliation values",
-    "items": {
-      "enum": [
-        "REPUBLICAN",
-        "DEMOCRAT",
-        "LIBERTARIAN",
-        "GREEN",
-        "INDEPENDENT",
-        "REFORM",
-        "NO AFFILIATION"
-      ],
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "d_presence_of_children": {
-    "description": "Set to \"Y\" to include households with children present",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_refi_amount": {
-    "description": "Refinance amount in thousands (single value or range)",
-    "pattern": "^\\d+(-\\d+)?$",
-    "type": "string"
-  },
-  "d_refi_date": {
-    "description": "Refinance date or date range using YYYYMMDD format",
-    "pattern": "^\\d{8}(-\\d{8})?$",
-    "type": "string"
-  },
-  "d_refi_loan_type": {
-    "description": "Refinance loan type codes. See values in options tool",
-    "enum": [
-      "5",
-      "C",
-      "F",
-      "P",
-      "S",
-      "U",
-      "W"
-    ],
-    "type": "string"
-  },
-  "d_refi_rate_type": {
-    "description": "Refinance rate type codes. A=Adjustable, B=Balloon, F=Fixed, U=Unknown",
-    "enum": [
-      "A",
-      "B",
-      "F",
-      "U"
-    ],
-    "type": "string"
-  },
-  "d_religion": {
-    "description": "Religion codes. See values in options tool",
-    "items": {
-      "pattern": "^[A-Z]$",
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "d_salesvolume": {
-    "description": "Company revenue range, in the format \"min-max\" (e.g. \"100000-1000000\" for $100K to $1M)",
-    "type": "string"
-  },
-  "d_senior_hhld": {
-    "description": "Set to \"Y\" to include households associated with senior households.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_shooting": {
-    "description": "Set to \"Y\" to include households associated with shooting sports interest.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_sic": {
-    "description": "Legacy 4-digit SIC codes",
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "d_singleparent": {
-    "description": "Set to \"Y\" to include households associated with single parent households.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_soho": {
-    "description": "Set to \"Y\" to include households associated with small office/home office households.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_state": {
-    "description": "Array of 2-letter state codes to filter by",
-    "items": {
-      "pattern": "^[A-Z]{2}$",
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "d_travel": {
-    "description": "Set to \"Y\" to include households associated with travel interest.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_weightloss": {
-    "description": "Set to \"Y\" to include households associated with dieting and weight loss interest.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_workingwoman": {
-    "description": "Set to \"Y\" to include households associated with working women households.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_youngadult_hhld": {
-    "description": "Set to \"Y\" to include households associated with young adult households.",
-    "enum": [
-      "Y"
-    ],
-    "type": "string"
-  },
-  "d_zip": {
-    "description": "Array of 5-digit ZIP codes to filter by",
-    "items": {
-      "pattern": "^\\d{5}$",
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "include_demo_categories": {
-    "description": "Demographic category summaries to include in the response. Recommended to include at least one with estimate calls for audience insights in the preview response",
-    "items": {
-      "enum": [
-        "b2cDemographic",
-        "b2cHouseFinAuto",
-        "b2cLifestyleInterest",
-        "b2cPoliticalDonor",
-        "firmographic"
-      ],
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "include_filter_attrs": {
-    "description": "Include selected filter attributes as columns in the final audience",
-    "type": "boolean"
-  },
-  "max_coverage": {
-    "description": "Request append processing for selected channels (must overlap required/optional fields)",
-    "items": {
-      "enum": [
-        "email",
-        "phone",
-        "phone_multiple",
-        "phone_mobile",
-        "phone_multiple_mobile",
-        "oa"
-      ],
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "max_records": {
-    "description": "Cap the number of records returned by the eventual list build",
-    "minimum": 1,
-    "type": "integer"
-  },
-  "optional_fields": {
-    "description": "Optional contact fields to include when available",
-    "items": {
-      "enum": [
-        "address",
-        "email",
-        "phone",
-        "phone_multiple",
-        "phone_mobile",
-        "phone_multiple_mobile",
-        "oa"
-      ],
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "output": {
-    "description": "Campaign type specification. Must include exactly one: \"email\" or \"oa\". Email should almost always be used; OA can ONLY be used for audience targeting in ad platforms and will return hashed data",
-    "items": {
-      "enum": [
-        "email",
-        "oa"
-      ],
-      "type": "string"
-    },
-    "maxItems": 1,
-    "minItems": 1,
-    "type": "array"
-  },
-  "rcfg_max_time": {
-    "description": "Maximum allowed API run time in seconds",
-    "minimum": 0.1,
-    "type": "number"
-  },
-  "rcfg_phone_format": {
-    "description": "Set to 1 to prefix returned phone numbers with the country code",
-    "enum": [
-      1
-    ],
-    "type": "integer"
-  },
-  "rd_department": {
-    "description": "Job departments. Use the options tool to retrieve valid values",
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "rd_role": {
-    "description": "Job roles. Use the options tool to retrieve valid values",
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "rd_title_seniority": {
-    "description": "Title seniority levels",
-    "items": {
-      "enum": [
-        "Owner/President",
-        "C-Level",
-        "VP/Sr. Executive",
-        "Director",
-        "Manager",
-        "Non-Manager"
-      ],
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "required_fields": {
-    "description": "Required output contact fields. Must include at least one. Recommended to include address for estimate calls for geo info. IMPORTANT: Unlike the B2B Persona API, this field along with optional_fields are used to define output instead of the \"output\" parameter",
-    "items": {
-      "enum": [
-        "address",
-        "email",
-        "phone",
-        "phone_multiple",
-        "phone_mobile",
-        "phone_multiple_mobile",
-        "oa"
-      ],
-      "type": "string"
-    },
-    "minItems": 1,
-    "type": "array"
-  }
-}

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "properties": {
+    "job_guid": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "job_id": {
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "job_operation": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "job_state": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "list_name": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "output_list_id": {
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "project_id": {
+      "type": [
+        "integer",
+        "null"
+      ]
+    }
+  },
+  "type": "object"
+}

First observedAug 19, 2026

TDQS

A4/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare this is a non-read-only, non-destructive, non-idempotent operation. The description adds important behavioral context beyond annotations: setup prerequisites and charge-on-finish consent requirements, including the `consent_required_job_types` meta field.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The purpose is front-loaded in the first sentence, followed by actionable prerequisites and consent guidance. The description is appropriately sized with little waste, though it could trim minor phrasing.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the rich input schema, output schema, and annotations, the description covers the key workflow details an agent needs: listgen vs enrichment, setup_list prerequisite, project selection preference, and consent handling. Remaining details such as job polling are covered by output schema and sibling tools.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description adds workflow meaning beyond the schema: use `project_id` when possible, run `setup_list` before enrichment, and only set consent after user approval. It also references the `consent_required_job_types` meta field.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: "Create a listgen job, or a batch enrichment job over one of the user's lists." It is clear enough to distinguish creation from inspection/status siblings, but it does not explicitly name alternatives such as the estimate or job_status tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives concrete prerequisites: run `setup_list` first for enrichment, prefer `project_id` when possible, and obtain consent before setting `usage_consent_confirmed = true`. It does not explicitly state when not to use this tool or name alternative sibling tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Versium REACH tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?