validate_pix_key
Validates Brazilian PIX keys for instant payments, supporting CPF, CNPJ, email, phone, and EVP formats. Returns validation status and key type.
Instructions
Validates a Brazilian PIX key — the instant payment identifier used by Brazil's central bank payment system (Banco Central do Brasil). Supports all 4 PIX key types: CPF (11 digits), CNPJ (14 digits), email address, phone number (+55 format), and EVP (random UUID key). Returns { valid: boolean, type: 'cpf'|'cnpj'|'email'|'phone'|'evp', key: string } or { valid: false, reason: string }. Use when processing PIX transfers, validating payment recipients, or building Brazilian payment flows in AI agents.
Tool 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": {
"key": "<key>"
},
"name": "validate_pix_key"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | Yes | PIX key to validate. Can be CPF, CNPJ, email, phone (+5511999999999) or EVP UUID. Example: 'user@email.com' or '+5511987654321' |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| valid | Yes | ||
| type | No | ||
| key | No | ||
| reason | No |