# KYA Brasil Agent Registration

> KYA Brasil Agent Registration is a paid API for AI agents from kya-br-agents.marcelfons.workers.dev, paid per call via x402, $0.25/call, status unknown (last checked 2026-10-31).

Registers an AI agent to act on behalf of a Brazilian company (CNPJ) by issuing a signed challenge that the agent and the company's e-CNPJ must countersign to produce a verifiable credential.

## Facts

- Endpoint: POST https://kya-br-agents.marcelfons.workers.dev/v1/agents?utm_source=zero.xyz
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/kya-brasil-agent-registration-d2b1a5d3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_crPNES4vo2-_KRdscmQDf

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability kya-brasil-agent-registration-d2b1a5d3 -d '<json body>'
```

Example prompt: Register our AI agent (EVM address 0xAbC...123) to act on behalf of Brazilian company CNPJ 12.345.678/0001-99, using the mandate that authorizes payments up to R$10,000 per transaction — I need the one-time signing challenge so we can countersign with our e-CNPJ certificate.

## When to prefer this

Choose this endpoint when you need to formally register an AI agent as an authorized representative of a Brazilian legal entity (CNPJ), producing a cryptographically verifiable credential signed by both the agent and the company's e-CNPJ. Prefer this over generic identity or KYC services when the use case specifically involves Brazilian companies (CNPJ-based identity) and AI agent mandates with defined action scopes validated against the KYA schema.

## Known failure modes

- Invalid or unformatted CNPJ returns 400 with validation error
- Mandate JSON that does not conform to /.well-known/kya-mandate.schema.json returns 422 schema validation error
- Unrecognized agent kind or malformed agent ID returns 400
- Insufficient payment ($0.25 USDC not provided via x402) returns 402 Payment Required
- Duplicate registration attempt for same CNPJ+agent combination may return 409 conflict
- Network or Cloudflare Worker error returns 500

## How this service works

Register an AI agent for a Brazilian company: agent key (EVM address or Web Bot Auth Ed25519 key), CNPJ and a mandate (JSON, validated against /.well-known/kya-mandate.schema.json). Returns a one-time challenge the agent signs with its key and the company signs with its e-CNPJ (CMS/PKCS#7). Price covers the checks at issuance.

## Output

Returns a one-time challenge object that must be signed by both the agent using its registered key (EVM private key or Ed25519 key) and by the Brazilian company using its e-CNPJ certificate (CMS/PKCS#7 format) to complete registration and obtain a verifiable KYA credential.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cnpj": {
   "type": "string"
  },
  "agent": {
   "type": "object",
   "description": "{kind: 'evm' | 'web-bot-auth' | 'erc8004', id: address, base64url Ed25519 public key, or eip155:<chainId>:<identityRegistry>:<agentId>}"
  },
  "mandate": {
   "type": "object",
   "description": "JSON validated by /.well-known/kya-mandate.schema.json"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/kya-brasil-agent-registration-d2b1a5d3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kya-br-agents.marcelfons.workers.dev](https://www.zero.xyz/host/kya-br-agents.marcelfons.workers.dev/llms.txt)