Kya Brasil

io.github.celfons由 GitHub 账号 celfons 发布v0.4.1更新于 Oct 25, 2026

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

已验证Streamable HTTP可网页运行安全与监控商业与电商

概览

AI 生成的概览

KYA Brasil 远程 MCP 服务器,让助手注册、验证、续期和撤销由巴西公司 e-CNPJ 签名的 AI 代理凭证。

可以做什么
注册代理并完成巴西公司的 e-CNPJ 签名流程,包括签名链接、提交证明、凭证续期与撤销,以及公司 webhook 设置和代理列表。验证代理的凭证、状态与授权范围,并检查某项操作或金额是否在授权范围内。将个人 CPF 与代理背后的 e-CPF 持有人进行匹配,并列出该人的有效凭证。查询某日期以来的撤销记录,并获取服务说明、价格与 schema 概览。
适用场景
当助手需要代表巴西公司行事,并要求与真实 CNPJ 绑定的可验证、可撤销授权时使用;或当验证方需要关于代理凭证、授权范围或撤销状态的签名答复时使用。
运行要求
远程 streamable HTTP 端点;无需本地运行时、软件包或声明的身份验证。需要代理的 EVM 地址或 Web Bot Auth Ed25519 密钥、CNPJ,以及公司持有的 e-CNPJ 证书(A1 文件、A3 令牌或云端签名器)来签署挑战。部分工具通过 x402 按次付费。
安装前请注意
多个工具按次收费,包括付费验证和主体匹配。注册、续期和撤销依赖 e-CNPJ 签名,且公司须在 Receita 处于 ATIVA 状态。webhook 设置会保存一个接收签名事件的 URL。CPF 数据会与 e-CPF 持有人核对;服务声明 CPF 不会被存储、发布或泄露。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Kya Brasil,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.celfons%2Fkya-brasil/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "kya-brasil": {
      "type": "http",
      "url": "https://kya-br-agents.marcelfons.workers.dev/mcp"
    }
  }
}

工具

15

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.

输入参数cnpjagent必填mandate必填principal

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.

输入参数credential_id必填

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.

输入参数actionamountcurrencyspent_todaycounterpartycredential_id必填payment_networkpayment_ref_sha256

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.

输入参数credential_id必填

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).

输入参数challenge_id必填credential_id必填agent_signature必填ecnpj_signature必填

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.

输入参数cpf必填credential_id必填

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).

输入参数signed_text必填ecpf_signature必填

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=.

输入参数agentcredential_id

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.

输入参数challenge_id必填credential_id必填agent_signature必填ecnpj_signature必填

kya_revoke

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

输入参数reasonsigned_text必填credential_id必填ecnpj_signature必填

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>".

输入参数cnpj必填signed_text必填ecnpj_signature必填

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.

输入参数cnpj必填signed_text必填ecnpj_signature必填

kya_revocations

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

输入参数since

kya_about

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

无需输入参数。

版本历史

2
  1. v0.4.1最新Oct 13, 2026
  2. v0.2.1Oct 13, 2026

评分

已满足适用检查项的 83%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分

    请声明包含 README 的 GitHub 仓库,或在 OAuth 受保护资源元数据中提供 resource_documentation。

  • 许可证不适用

    托管服务按其提供方的条款使用,因此这里不要求许可证。此检查项不计入百分比。