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。

  • 授權條款不適用

    託管服務按其提供方的條款使用,因此這裡不要求授權條款。此檢查項不計入百分比。