Versium REACH

Create Job Mcp Tool

create_job

Create a B2B or B2C listgen job for the authenticated user.

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. Read the `consent_required_job_types` meta field to know which job types require consent.

Input Schema

TableJSON Schema

Name	Required	Description
`name`	Yes	Output list name
`config`	Yes	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.
`job_type`	Yes	Selects the internal operation branch for the nested config payload
`project_id`	No	Preferred project target when the user already has a project
`project_name`	No	Fallback project name when the user wants MCP to create/find the project
`usage_consent_confirmed`	No	Set to true to confirm the user has consented to usage charges. Required for job types that bill upon completion.

Output Schema

TableJSON 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.

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/5.0

Behavior4/5

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

Annotations already declare readOnlyHint=false, destructiveHint=false, idempotentHint=false, so the agent knows this is a mutating, non-idempotent operation. The description adds important behavioral context: it creates a job for the authenticated user, may charge on finish, and requires explicit consent for certain job types. It doesn't contradict annotations.

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 description is compact and front-loaded with the core purpose. The usage guidance is packed into two sentences without fluff. Slight deduction for not structuring the consent guidance as a separate bullet, but it's still clear and efficient.

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?

The description covers the key operational details: authentication context, project_id preference, consent requirement, and config shape reference. The output schema exists, so return values are documented elsewhere. It could mention what happens after job creation (e.g., job_status polling) but that's covered by 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 description coverage is 100%, so the schema already documents all parameters. The description adds value by explaining the consent flow (usage_consent_confirmed) and the relationship between config and the estimate tools' input shape. It also clarifies that b2b_listgen requires output and b2c_listgen requires required_fields, which goes beyond the schema.

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

Purpose5/5

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

The description states a specific verb ('Create'), a resource ('B2B or B2C listgen job'), and the target user ('authenticated user'). It clearly distinguishes from sibling tools like b2b_listgen_estimate and b2b_listgen_options by focusing on job creation rather than estimation or options.

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

Usage Guidelines5/5

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

The description gives explicit usage guidance: use project_id when possible, only submit usage_consent_confirmed=true after user consent, and read consent_required_job_types meta field to know which job types require consent. This is actionable and distinguishes when to use this tool vs alternatives.

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?