is_litigator Tool - Contact Center Compliance

The is_litigator tool checks if one or more phone numbers are associated with individuals who have filed TCPA (Telephone Consumer Protection Act) or related consumer-protection lawsuits.

Parameters

phoneNumbers

string[]

required

Phone numbers in 10-digit North American format (e.g., "8663625478").

API key. Only required if not provided via the x-dncscrub-api-key HTTP header.

campaignId

number

Campaign ID in DNCScrub for usage tracking and sensitivity configuration.

projId

string

Project ID in DNCScrub for usage tracking and sensitivity configuration.

Response

success

boolean

Whether the API call succeeded.

results

array

Array of phone check results (when successful).

Show results object

phone

string

The phone number that was checked.

isLitigator

boolean

true if the number belongs to a known litigator.

errorCode

string

Machine-readable error code (when failed).

errorMessage

string

Human-readable error description (when failed).

Error Codes

Code	Description
`MISSING_API_KEY`	No API key provided in header or parameter
`INVALID_API_KEY`	The API key is invalid or unauthorized
`API_ERROR`	DNCScrub API returned an error
`MISSING_INPUT`	Required parameters are missing

Examples

Request
Success Response
Error Response

{
  "phoneNumbers": ["8663625478", "5551234567"]
}

{
  "success": true,
  "results": [
    { "phone": "8663625478", "isLitigator": false },
    { "phone": "5551234567", "isLitigator": true }
  ]
}

{
  "success": false,
  "errorCode": "INVALID_API_KEY",
  "errorMessage": "The provided API key is invalid or unauthorized"
}

Usage Notes

Check multiple numbers in a single request for better performance
Results are returned in the same order as the input array
Phone numbers should be 10 digits without formatting (no dashes, spaces, or country code)

MCP Server for AI Applications

​Parameters

​Response

​Error Codes

​Examples

​Usage Notes

Parameters

Response

Error Codes

Examples

Usage Notes