{"uid":"cap_crPNES4vo2-_KRdscmQDf","slug":"kya-brasil-agent-registration-d2b1a5d3","name":"KYA Brasil Agent Registration","description":"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.","url":"https://kya-br-agents.marcelfons.workers.dev/v1/agents?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_v1tf0lGAbL9J4yFmfBaT_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Onboard payment automation agent","prompt":"I need to register our payment automation agent — its EVM address is 0xDe4...F9a — to act on behalf of our São Paulo company with CNPJ 45.678.901/0001-55. Its mandate allows it to approve supplier payments up to R$50,000. Give me the challenge so we can sign it with our e-CNPJ."},{"title":"Register compliance monitoring bot","prompt":"Register our compliance monitoring bot using its Ed25519 web-bot-auth public key for Brazilian entity CNPJ 98.765.432/0001-11. The mandate restricts it to read-only reporting actions. I need the one-time challenge returned so our legal team can sign it with the company e-CNPJ certificate."},{"title":"Bind ERC-8004 agent to CNPJ","prompt":"We have an ERC-8004 agent on chain eip155:1 with identity registry 0xReg...001 and agent ID 42 that we want to bind to our Brazilian holding company CNPJ 33.222.111/0001-88 under a mandate that covers procurement actions up to R$20,000 — start the KYA registration and return the signing challenge."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T06:42:26.126Z","isFirstParty":false,"canonicalSlug":"kya-brasil-agent-registration-d2b1a5d3"}