io.github.celfonsPublished by GitHub account celfonsv0.4.1Updated Oct 25, 2026
KYA backed by a real company: e-CNPJ-signed agent mandates, revocation-checked, signed verdicts
Remote MCP server for KYA Brasil that lets an assistant register, verify, renew and revoke Brazilian company-backed AI agent credentials signed with e-CNPJ.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.celfons%2Fkya-brasil/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"kya-brasil": {
"type": "http",
"url": "https://kya-br-agents.marcelfons.workers.dev/mcp"
}
}
}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.
cnpjagentrequiredmandaterequiredprincipalSame as the free verification, without daily limit, plus a signed receipt of the verification itself (what was checked, when). Pay per call with x402.
credential_idrequiredSigned 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.
actionamountcurrencyspent_todaycounterpartycredential_idrequiredpayment_networkpayment_ref_sha256Re-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.
credential_idrequiredFree. 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).
challenge_idrequiredcredential_idrequiredagent_signaturerequiredecnpj_signaturerequiredSigned 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.
cpfrequiredcredential_idrequiredFree, 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).
signed_textrequiredecpf_signaturerequiredFree. 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.
challenge_idrequiredcredential_idrequiredagent_signatureFree (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=.
agentcredential_idFree. 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.
challenge_idrequiredcredential_idrequiredagent_signaturerequiredecnpj_signaturerequiredFree. The company revokes the credential at once (e-CNPJ-signed request). Revocations are listed at /v1/revocations.
reasonsigned_textrequiredcredential_idrequiredecnpj_signaturerequiredFree, 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>".
cnpjrequiredsigned_textrequiredecnpj_signaturerequiredFree, 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.
cnpjrequiredsigned_textrequiredecnpj_signaturerequiredFree. Credentials revoked since a date (default: last 30 days), for verifiers that cache credentials.
sinceFree. What KYA Brasil is, how the credential flow works, prices, and where the schemas and signing keys are.
Takes no parameters.
83% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.
A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.