# io.github.celfons/kya-brasil > KYA backed by a real company: e-CNPJ-signed agent mandates, revocation-checked, signed verdicts - name: io.github.celfons/kya-brasil - version: 0.4.1 - connection class: R0 (autonomous) - trust: 79/100 flags: no-repository - quality: 77/100 (good) - owner: not claimed - descriptor: https://api.protogrid.dev/v1/servers/io.github.celfons%2Fkya-brasil - tools: https://api.protogrid.dev/v1/servers/io.github.celfons%2Fkya-brasil/tools **An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe. ## Connection (mcpServers) ```json { "mcpServers": { "kya-brasil": { "type": "http", "url": "https://kya-br-agents.marcelfons.workers.dev/mcp" } } } ``` ## Trust - hygiene: 80 - liveness: 99 - freshness: 100 - provenance: 45 - drivers: +website +reachable +uptime-97% +updated-7d-ago -no-repository - Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. ## Quality 77/100 (good) ### protocol: 75 (weight 25) - warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28 - n/a `protocol.stateless`: only applies to 2026-07-28 servers - pass `protocol.transport`: streamable HTTP - n/a `protocol.list_ttl`: only applies to 2026-07-28 servers ### authorization: n/a (weight 15) - n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth - n/a `auth.secret_in_url`: no templated URL ### tool hygiene: 79 (weight 30) - pass `tools.descriptions`: every tool has a description - pass `tools.description_length`: descriptions are concise - pass `tools.schemas`: every tool has an object input schema - warn `tools.annotations`: only 10 of 15 tools declare readOnlyHint or destructiveHint - fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: kya_register (readOnlyHint, destructiveHint, idempotentHint); kya_verify (destructiveHint, idempotentHint); kya_verify_paid (destructiveHint, idempotentHint); … - pass `tools.token_cost`: about 3,481 tokens to load every tool - pass `tools.api_dump`: tools are not a one-to-one API dump ### stability: 75 (weight 15) - warn `stability.changes`: 23 tool changes in 30 days - pass `stability.rug_pull`: no tool changed its meaning under the same name ### dependencies: n/a (weight 15) - n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package - tools: 15, about 3,481 tokens to load them all - tool set hash: 7e6b4153b2096da79d008cd2e160ba33 - tools last changed: 2026-10-14T18:42:49.853Z - badge: [![protogrid quality](https://protogrid.dev/badge/io.github.celfons/kya-brasil.svg)](https://protogrid.dev/servers/io.github.celfons/kya-brasil) - Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. ### Tool changes - 2026-10-14 `kya_sign_link` added - 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. - 2026-10-14 `kya_person_agents` added - Free, person only: every live credential behind your e-CPF and every CPF check made against each one. Sign "KYA Brasil: my agents\nat: " with the e-CPF (valid 10 minutes). - 2026-10-14 `kya_principal_match` added - 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. - 2026-10-14 `kya_check_action` changed (description, inputSchema) - before: 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. - after: 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. - 2026-10-14 `kya_register` changed (inputSchema) - 2026-10-13 `kya_verify` changed (description) - before: Free (50/day per IP). The agent's current credential: principal company, mandate, informative KYB snapshot, status (active, suspended, revoked, expired) and signature. Also by key: /v1/agents/by-key?kind=&id=. - after: 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=. - 2026-10-13 `kya_acts_export` removed - Free. The company's trail of everything registered for one of its agents (default 30 days). The request is signed with the company's e-CNPJ, so only the principal reads it. - 2026-10-13 `kya_act_text` removed - Free. The exact text an agent signs to show it intended an act (optional agent_signature of kya_register_act). - 2026-10-13 `kya_act` removed - Free. A registered act and its signed receipt, by act_id (the receipt holder has it). - 2026-10-13 `kya_register_act` removed - Register what the agent did (action, amount, currency, counterparty, reference, optional document hash and agent signature), usually by the party that accepted it. The issuer checks it against the mandate, adding what was already registered today, and returns a signed receipt. Denied acts are recorded too. The receipt is the proof of what the agent could and did do at that moment. Full history: https://api.protogrid.dev/v1/servers/io.github.celfons%2Fkya-brasil/changes ## Remotes - https://kya-br-agents.marcelfons.workers.dev/mcp (streamable-http, auth none, reachable true, uptime30d 0.96666664) ## Packages _none_ ## Tools (15) - `kya_about`: Free. What KYA Brasil is, how the credential flow works, prices, and where the schemas and signing keys are. - `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. - `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 " + "at: ". - `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. - `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: " with the e-CPF (valid 10 minutes). - `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. - `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). - `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. - `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. - `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. - `kya_revocations`: Free. Credentials revoked since a date (default: last 30 days), for verifiers that cache credentials. - `kya_revoke`: Free. The company revokes the credential at once (e-CNPJ-signed request). Revocations are listed at /v1/revocations. - `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. - `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=. - `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.