kya-brasil

Server Details

Know-your-agent for Brazil: e-CNPJ-signed credentials binding AI agents to companies, KYB-checked

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.

Status: Healthy
Last Tested: 2026-10-13 01:13
Transport: Streamable HTTP · MCP 2025-11-25
URL

TDQS

Score is being calculated.

Available Tools

10 tools

kya_about

Read-onlyIdempotent

Inspect

Free. What KYA Brasil is, how the credential flow works, prices, and where the schemas and signing keys are.

ParametersJSON Schema

Name	Required	Description	Default
No parameters

kya_check_action

Read-only

Inspect

Signed verdict: is this action (action, amount, currency, counterparty) inside the agent's mandate and is the credential active? Evaluates the reserved mandate fields; lists the fields it did not evaluate.

ParametersJSON Schema

Name	Required	Description
`action`	No	Action the agent wants to perform (e.g. pay, order, sign).
`amount`	No
`currency`	No	BRL, USDC, ...
`spent_today`	No	What this agent already spent today, if you track it (used for max_per_day).
`counterparty`	No	CNPJ, domain or wallet address of the other side.
`credential_id`	Yes	credential_id returned by kya_register.

kya_proveInspect

Free. Send both signatures of the challenge. The e-CNPJ chain is validated against ICP-Brasil roots, the CNPJ must match, KYB Brasil must clear the company; then the credential is issued (90 days, Ed25519-signed).

ParametersJSON Schema

Name	Required	Description
`challenge_id`	Yes	challenge.id from kya_register (or kya_renew).
`credential_id`	Yes	credential_id returned by kya_register.
`agent_signature`	Yes	Signature of challenge.text by the agent key: EIP-191 personal_sign hex (evm) or raw Ed25519 base64url (web-bot-auth).
`ecnpj_signature`	Yes	CMS/PKCS#7 SignedData (detached, base64 DER) of challenge.text, signed with the company's e-CNPJ certificate.

kya_registerInspect

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 KYB check at issuance.

ParametersJSON Schema

Name	Required	Description
`cnpj`	Yes	The company's CNPJ, with or without punctuation.
`agent`	Yes
`mandate`	Yes	Mandate JSON validated by https://kya-br-agents.marcelfons.workers.dev/.well-known/kya-mandate.schema.json. Reserved fields: actions, max_per_operation, max_per_day, currencies, counterparties, valid_from, valid_until.

kya_renewInspect

Re-issue the credential for 90 more days if KYB Brasil still clears the company. The company signs the renewal challenge with its e-CNPJ.

ParametersJSON Schema

Name	Required	Description	Default
`credential_id`	Yes	credential_id returned by kya_register.

kya_renew_proveInspect

Free. Second step of kya_renew: send both signatures of the renewal challenge; the credential is re-issued for 90 days if KYB Brasil still clears the company.

ParametersJSON Schema

Name	Required	Description
`challenge_id`	Yes	challenge.id from kya_register (or kya_renew).
`credential_id`	Yes	credential_id returned by kya_register.
`agent_signature`	Yes	Signature of challenge.text by the agent key: EIP-191 personal_sign hex (evm) or raw Ed25519 base64url (web-bot-auth).
`ecnpj_signature`	Yes	CMS/PKCS#7 SignedData (detached, base64 DER) of challenge.text, signed with the company's e-CNPJ certificate.

kya_revocations

Read-onlyIdempotent

Inspect

Free. Credentials revoked since a date (default: last 30 days), for verifiers that cache credentials.

ParametersJSON Schema

Name	Required	Description	Default
`since`	No

kya_revoke

Destructive

Inspect

Free. The company revokes the credential at once (e-CNPJ-signed request). Revocations are listed at /v1/revocations.

ParametersJSON Schema

Name	Required	Description
`reason`	No
`signed_text`	Yes	Exactly "KYA Brasil: revoke <credential_id>" followed by a newline and a nonce of your choice.
`credential_id`	Yes	credential_id returned by kya_register.
`ecnpj_signature`	Yes	CMS/PKCS#7 SignedData (detached, base64 DER) of signed_text with the company's e-CNPJ.

kya_verify

Read-only

Inspect

Free (50/day per IP). The agent's current credential: principal company, mandate, KYB snapshot, status (active, suspended, revoked, expired) and signature. Also by key: /v1/agents/by-key?kind=&id=.

ParametersJSON Schema

Name	Required	Description	Default
`agent`	No	Alternative to credential_id: look up active credentials by agent key.
`credential_id`	No	credential_id returned by kya_register.

kya_verify_paid

Read-only

Inspect

Same as the free verification, without daily limit, plus a signed receipt of the verification itself (what was checked, when). Pay per call with x402.

ParametersJSON Schema

Name	Required	Description	Default
`credential_id`	Yes	credential_id returned by kya_register.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

2 tool updatesOct 13, 2026

Changedkya_register4 fields changed

changedInput schema / properties / agent / properties / id / description

Previous value: -"0x address for evm; base64url raw Ed25519 public key for web-bot-auth."New value: +"0x address for evm; base64url raw Ed25519 public key for web-bot-auth; eip155:<chainId>:<identityRegistry>:<agentId> for erc8004."

changedInput schema / properties / agent / properties / id / maxLength
```
Previous value: -128New value: +160
```

changedInput schema / properties / agent / properties / kind / description

Previous value: -"evm: an Ethereum-style wallet (EIP-191 signatures). web-bot-auth: an Ed25519 key (RFC 9421 / Web Bot Auth)."New value: +"evm: an Ethereum-style wallet (EIP-191 signatures). web-bot-auth: an Ed25519 key (RFC 9421 / Web Bot Auth). erc8004: an agent registered in an ERC-8004 Identity Registry; its on-chain agentWallet signs."

changedInput schema / properties / agent / properties / kind / enum

Previous value: -[
-  "evm",
-  "web-bot-auth"
-]New value: +[
+  "evm",
+  "web-bot-auth",
+  "erc8004"
+]

Changedkya_verify4 fields changed

changedInput schema / properties / agent / properties / id / description

Previous value: -"0x address for evm; base64url raw Ed25519 public key for web-bot-auth."New value: +"0x address for evm; base64url raw Ed25519 public key for web-bot-auth; eip155:<chainId>:<identityRegistry>:<agentId> for erc8004."

changedInput schema / properties / agent / properties / id / maxLength
```
Previous value: -128New value: +160
```

changedInput schema / properties / agent / properties / kind / description

Previous value: -"evm: an Ethereum-style wallet (EIP-191 signatures). web-bot-auth: an Ed25519 key (RFC 9421 / Web Bot Auth)."New value: +"evm: an Ethereum-style wallet (EIP-191 signatures). web-bot-auth: an Ed25519 key (RFC 9421 / Web Bot Auth). erc8004: an agent registered in an ERC-8004 Identity Registry; its on-chain agentWallet signs."

changedInput schema / properties / agent / properties / kind / enum

Previous value: -[
-  "evm",
-  "web-bot-auth"
-]New value: +[
+  "evm",
+  "web-bot-auth",
+  "erc8004"
+]

10 tool updatesOct 13, 2026
- First observedkya_about
- First observedkya_check_action
- First observedkya_prove
- First observedkya_register
- First observedkya_renew
- First observedkya_renew_prove
- First observedkya_revocations
- First observedkya_revoke
- First observedkya_verify
- First observedkya_verify_paid

Related MCP Connectors

HiveTrust
io.github.srotzin
KYA identity verification, trust scoring, and performance bonds for AI agents
Security Autonomous Agents AI & Machine Learning
2
Hive Identity A
io.github.srotzin
W3C DID issuance and verification for autonomous AI agents
Web3 & Decentralized Tech Autonomous Agents Security
42
Kevros — Agentic Identity Trust A
io.github.ndl-systems
Agentic identity trust: precision decisioning, cryptographic release tokens, hash-chained proof
Autonomous Agents Security Blockchain
921
DataBR — API de Dados Públicos Brasileiros
io.github.igorpdev
Brazilian public data API for AI agents. BCB, IBGE, CVM, B3, compliance. x402 payments on Base.
Government Data Open Data Finance
2

Related MCP Servers

hive-mcp-identity
Security Blockchain Autonomous Agents
srotzin
A
license
Not graded
quality
C
maintenance
W3C DID resolution and agent KYC for autonomous agent counterparties, enabling identity verification and trust scoring.
Updated 5 months ago (2026-05-09 22:37 UTC)
MIT
soulprint
Web3 & Decentralized Tech Blockchain Security
manuelariasfz
A
license
Not graded
quality
D
maintenance
Decentralized KYC identity protocol for AI agents. Proves there's a verified human behind any bot using Zero-Knowledge Proofs. No servers, no PII stored.
Updated 7 months ago (2026-03-02 03:54 UTC)
2 npm
5
MIT
EUDI Wallet MCP
Security Legal & Compliance
CSOAI-ORG
A
license
Not graded
quality
C
maintenance
EU Digital Identity Wallet (eIDAS 2.0) for AI agents, compliant with MCP protocol and EU AI Act.
Updated 4 months ago (2026-06-26 05:31 UTC)
37 PyPI
MIT
hivetrust
Autonomous Agents Blockchain Security
srotzin
A
license
Not graded
quality
D
maintenance
KYA (Know Your Agent) identity, trust scoring, and insurance protocol for autonomous AI agents. Issues verifiable credentials, computes real-time trust scores, and provides agent liability coverage on Base L2.
Updated 2 months ago (2026-07-30 16:25 UTC)
MIT