Servers Playground How we check Add a server Log in

Kya Brasil

Working · 4.3 s

io.github.celfons/kya-brasilv0.4.1

KYA backed by a real company: e-CNPJ-signed agent mandates, revocation-checked, signed verdicts

Security Legal & Government

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://kya-br-agents.marcelfons.workers.dev/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

kya_about Read-only

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

This tool takes no arguments.

Kya Brasil MCP server | mcptry

Tools (15)

kya_about

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

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

kya_check_action

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

read-only

Argument	Type	Description
action	string	Action the agent wants to perform (e.g. pay, order, sign).
amount	number
currency	string	BRL, USDC, ...
spent_today	number	What this agent already spent today, if you track it (used for max_per_day).
counterparty	string	CNPJ, domain or wallet address of the other side.
credential_id*	string	credential_id returned by kya_register.
payment_network	string	Payment network or rail of this operation: visa, mastercard, elo, pix, ...
payment_ref_sha256	string	SHA-256 hex of the payment token reference or PAR used (never a card number); checked against mandate.payment_instruments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "credential_id"
  ],
  "properties": {
    "action": {
      "type": "string",
      "maxLength": 64,
      "description": "Action the agent wants to perform (e.g. pay, order, sign)."
    },
    "amount": {
      "type": "number",
      "minimum": 0
    },
    "currency": {
      "type": "string",
      "maxLength": 12,
      "description": "BRL, USDC, ..."
    },
    "spent_today": {
      "type": "number",
      "minimum": 0,
      "description": "What this agent already spent today, if you track it (used for max_per_day)."
    },
    "counterparty": {
      "type": "string",
      "maxLength": 128,
      "description": "CNPJ, domain or wallet address of the other side."
    },
    "credential_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "credential_id returned by kya_register."
    },
    "payment_network": {
      "type": "string",
      "maxLength": 32,
      "description": "Payment network or rail of this operation: visa, mastercard, elo, pix, ..."
    },
    "payment_ref_sha256": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{64}$",
      "description": "SHA-256 hex of the payment token reference or PAR used (never a card number); checked against mandate.payment_instruments."
    }
  }
}

kya_company_agents

Free, company only. Every credential ever registered for your CNPJ, any status, whoever held the certificate (an accountant, another employee). Request signed with your e-CNPJ over "KYA Brasil: agents <cnpj>" + "at: <ISO time>".

read-only

Argument	Type	Description
cnpj*	string	The company's CNPJ.
signed_text*	string	"KYA Brasil: <agents\|webhook> <cnpj>", for the webhook a "url: <https url or ->" line, then "at: <ISO time>" (within 10 minutes).
ecnpj_signature*	string	CMS/PKCS#7 SignedData of signed_text with the company's e-CNPJ, detached, base64 DER.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "cnpj",
    "signed_text",
    "ecnpj_signature"
  ],
  "properties": {
    "cnpj": {
      "type": "string",
      "maxLength": 20,
      "description": "The company's CNPJ."
    },
    "signed_text": {
      "type": "string",
      "maxLength": 1200,
      "description": "\"KYA Brasil: <agents|webhook> <cnpj>\", for the webhook a \"url: <https url or ->\" line, then \"at: <ISO time>\" (within 10 minutes)."
    },
    "ecnpj_signature": {
      "type": "string",
      "description": "CMS/PKCS#7 SignedData of signed_text with the company's e-CNPJ, detached, base64 DER."
    }
  }
}

kya_company_webhook

Free, company only. Sets the https URL that receives signed events about your agents: credential issued, renewed, suspended, reinstated, revoked. Request signed with your e-CNPJ; url "-" removes it.

Argument	Type	Description
cnpj*	string	The company's CNPJ.
signed_text*	string	"KYA Brasil: <agents\|webhook> <cnpj>", for the webhook a "url: <https url or ->" line, then "at: <ISO time>" (within 10 minutes).
ecnpj_signature*	string	CMS/PKCS#7 SignedData of signed_text with the company's e-CNPJ, detached, base64 DER.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "cnpj",
    "signed_text",
    "ecnpj_signature"
  ],
  "properties": {
    "cnpj": {
      "type": "string",
      "maxLength": 20,
      "description": "The company's CNPJ."
    },
    "signed_text": {
      "type": "string",
      "maxLength": 1200,
      "description": "\"KYA Brasil: <agents|webhook> <cnpj>\", for the webhook a \"url: <https url or ->\" line, then \"at: <ISO time>\" (within 10 minutes)."
    },
    "ecnpj_signature": {
      "type": "string",
      "description": "CMS/PKCS#7 SignedData of signed_text with the company's e-CNPJ, detached, base64 DER."
    }
  }
}

kya_person_agents

Free, person only: every live credential behind your e-CPF and every CPF check made against each one. Sign "KYA Brasil: my agents\nat: <ISO time>" with the e-CPF (valid 10 minutes).

read-only

Argument	Type	Description
signed_text*	string	"KYA Brasil: my agents\nat: <ISO time>"
ecpf_signature*	string	CMS/PKCS#7 of signed_text with the person's e-CPF, base64 DER.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "signed_text",
    "ecpf_signature"
  ],
  "properties": {
    "signed_text": {
      "type": "string",
      "description": "\"KYA Brasil: my agents\\nat: <ISO time>\""
    },
    "ecpf_signature": {
      "type": "string",
      "description": "CMS/PKCS#7 of signed_text with the person's e-CPF, base64 DER."
    }
  }
}

kya_principal_match

Signed answer ($0.01) for a person's agent (principal.kind person): does the CPF you already have match the e-CPF holder behind it? On a match, a subject_ref of your own for that person (stable for you, different for every verifier). The CPF is never stored, published or revealed; 3 non-matching answers per credential stop your checks. The person sees every check.

read-only

Argument	Type	Description
cpf*	string	The CPF you already have for this person; used for the comparison only, never stored.
credential_id*	string	credential_id returned by kya_register.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "credential_id",
    "cpf"
  ],
  "properties": {
    "cpf": {
      "type": "string",
      "maxLength": 14,
      "minLength": 11,
      "description": "The CPF you already have for this person; used for the comparison only, never stored."
    },
    "credential_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "credential_id returned by kya_register."
    }
  }
}

kya_prove

Free. Send both signatures of the challenge. The e-CNPJ chain is validated against ICP-Brasil roots, the CNPJ must match, the certificate must not be revoked (CRL) and the company must be ATIVA; then the credential is issued (90 days, Ed25519-signed).

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

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "credential_id",
    "challenge_id",
    "agent_signature",
    "ecnpj_signature"
  ],
  "properties": {
    "challenge_id": {
      "type": "string",
      "description": "challenge.id from kya_register (or kya_renew)."
    },
    "credential_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "credential_id returned by kya_register."
    },
    "agent_signature": {
      "type": "string",
      "description": "Signature of challenge.text by the agent key: EIP-191 personal_sign hex (evm) or raw Ed25519 base64url (web-bot-auth)."
    },
    "ecnpj_signature": {
      "type": "string",
      "description": "CMS/PKCS#7 SignedData (detached, base64 DER) of challenge.text, signed with the company's e-CNPJ certificate."
    }
  }
}

kya_register

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.

Argument	Type	Description
cnpj	string	The company's CNPJ (company agents). Leave out with principal "person".
agent*	object
mandate*	object	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.
principal	string	"person": the agent acts for a natural person who signs with an e-CPF (no CNPJ; no name or CPF is ever published).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "agent",
    "mandate"
  ],
  "properties": {
    "cnpj": {
      "type": "string",
      "maxLength": 18,
      "minLength": 14,
      "description": "The company's CNPJ (company agents). Leave out with principal \"person\"."
    },
    "agent": {
      "type": "object",
      "required": [
        "kind",
        "id"
      ],
      "properties": {
        "id": {
          "type": "string",
          "maxLength": 160,
          "minLength": 20,
          "description": "0x address for evm; base64url raw Ed25519 public key for web-bot-auth; eip155:<chainId>:<identityRegistry>:<agentId> for erc8004."
        },
        "kind": {
          "enum": [
            "evm",
            "web-bot-auth",
            "erc8004"
          ],
          "type": "string",
          "description": "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."
        }
      }
    },
    "mandate": {
      "type": "object",
      "description": "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.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "principal": {
      "enum": [
        "company",
        "person"
      ],
      "type": "string",
      "description": "\"person\": the agent acts for a natural person who signs with an e-CPF (no CNPJ; no name or CPF is ever published)."
    }
  }
}

kya_renew

Re-issue the credential for 90 more days. The company signs the renewal challenge with an e-CNPJ in force (not revoked); the company must still be ATIVA at the Receita.

Argument	Type	Description
credential_id*	string	credential_id returned by kya_register.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "credential_id"
  ],
  "properties": {
    "credential_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "credential_id returned by kya_register."
    }
  }
}

kya_renew_prove

Free. Second step of kya_renew: send both signatures of the renewal challenge; the credential is re-issued for 90 days if the e-CNPJ is not revoked and the company is still ATIVA.

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

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "credential_id",
    "challenge_id",
    "agent_signature",
    "ecnpj_signature"
  ],
  "properties": {
    "challenge_id": {
      "type": "string",
      "description": "challenge.id from kya_register (or kya_renew)."
    },
    "credential_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "credential_id returned by kya_register."
    },
    "agent_signature": {
      "type": "string",
      "description": "Signature of challenge.text by the agent key: EIP-191 personal_sign hex (evm) or raw Ed25519 base64url (web-bot-auth)."
    },
    "ecnpj_signature": {
      "type": "string",
      "description": "CMS/PKCS#7 SignedData (detached, base64 DER) of challenge.text, signed with the company's e-CNPJ certificate."
    }
  }
}

kya_revocations

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

read-only

Argument	Type	Description
since	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "since": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  }
}

kya_revoke

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

destructive

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

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "credential_id",
    "signed_text",
    "ecnpj_signature"
  ],
  "properties": {
    "reason": {
      "type": "string",
      "maxLength": 200
    },
    "signed_text": {
      "type": "string",
      "description": "Exactly \"KYA Brasil: revoke <credential_id>\" followed by a newline and a nonce of your choice."
    },
    "credential_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "credential_id returned by kya_register."
    },
    "ecnpj_signature": {
      "type": "string",
      "description": "CMS/PKCS#7 SignedData (detached, base64 DER) of signed_text with the company's e-CNPJ."
    }
  }
}

kya_sign_link

Free. Link for whoever holds the company's e-CNPJ (owner, accountant): give challenge_id and the agent's signature, get the /sign URL. They see agent, company and mandate and sign in the browser (A1 .pfx) or with any ICP-Brasil signer (A3 token, cloud), or run kya-sign (npm @kya-brasil/agent-tools) with the link. The issuer never sees the certificate.

read-only

Argument	Type	Description
challenge_id*	string	challenge.id from kya_register or kya_renew.
credential_id*	string	credential_id returned by kya_register.
agent_signature	string	The agent's signature of challenge.text, so the person only signs with the e-CNPJ.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "credential_id",
    "challenge_id"
  ],
  "properties": {
    "challenge_id": {
      "type": "string",
      "description": "challenge.id from kya_register or kya_renew."
    },
    "credential_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "credential_id returned by kya_register."
    },
    "agent_signature": {
      "type": "string",
      "maxLength": 600,
      "description": "The agent's signature of challenge.text, so the person only signs with the e-CNPJ."
    }
  }
}

kya_verify

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

read-only

Argument	Type	Description
agent	object	Alternative to credential_id: look up active credentials by agent key.
credential_id	string	credential_id returned by kya_register.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "agent": {
      "type": "object",
      "required": [
        "kind",
        "id"
      ],
      "properties": {
        "id": {
          "type": "string",
          "maxLength": 160,
          "minLength": 20,
          "description": "0x address for evm; base64url raw Ed25519 public key for web-bot-auth; eip155:<chainId>:<identityRegistry>:<agentId> for erc8004."
        },
        "kind": {
          "enum": [
            "evm",
            "web-bot-auth",
            "erc8004"
          ],
          "type": "string",
          "description": "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."
        }
      },
      "description": "Alternative to credential_id: look up active credentials by agent key."
    },
    "credential_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "credential_id returned by kya_register."
    }
  }
}

kya_verify_paid

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.

read-only

Argument	Type	Description
credential_id*	string	credential_id returned by kya_register.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "credential_id"
  ],
  "properties": {
    "credential_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "credential_id returned by kya_register."
    }
  }
}