agentum-mcp-server

Name: agentum-mcp-server
Author: orionlabsai

本地服务

github.com/orionlabsai商业与营销16 周前更新

代码仓库

关于 agentum-mcp-server

agentum-mcp-server 将 AGENTUM 的巴西及全球商业、身份和经济数据 API 提供给 MCP 客户端中的 AI Agent。它通过 x402 在 Base 主网上按次以 USDC 付款，并在本地签署支付授权。

主要功能

01查询 CNPJ、CEP 和 CPF
02获取汇率及经济指标
03验证 VAT 并查询 LEI 公司
04提供企业情报与合规检查
05按次以 USDC 支付

适用场景

01核验巴西企业登记信息
02查询 CEP 对应的地址
03检查欧洲 VAT 或全球 LEI
04获取官方汇率及经济数据

MCP 相关

作为 MCP 服务，它向 AI Agent 暴露 AGENTUM 数据 API 工具。每次调用通过 x402 以 USDC 支付；支付签名在本地完成。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "orionlabsai-agentum": {
      "command": "npx",
      "args": [
        "-y",
        "@agentum/mcp-server"
      ],
      "env": {
        "AGENTUM_MCP_WALLET_KEY": "<AGENTUM_MCP_WALLET_KEY>"
      }
    }
  }
}

启动命令npx -y @agentum/mcp-server

需要配置的环境变量

AGENTUM_MCP_WALLET_KEY密钥Chave privada (0x... 64 hex) da sua própria carteira Ethereum, com saldo em USDC na rede Base. Nunca a chave da AGENTUM — cada usuário paga com a própria carteira.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@agentum/mcp-server1.2.5stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
cnpj	string	是	巴西 CNPJ，14 位数字，可带或不带标点

详细介绍

@agentum/mcp-server

MCP（Model Context Protocol）服务，将 AGENTUM 的真实 API （巴西及全球数据：CNPJ、CEP、官方费率、CPF、商业智能、LEI、欧洲 VAT、汇率、经济指标）作为工具公开，任何支持 MCP 的 AI Agent（Claude Desktop、 Claude Code、Cursor 等）都可以直接调用——按使用量付费，以真实 USDC 通过 x402 协议支付。

无需 API 密钥、无需注册、无需月度订阅。每次调用都是即时的链上支付（Base 主网），直接通过发布在 npm 上的软件包完成——使用时无需克隆此仓库。

快速开始（不到 5 分钟）

你需要准备两样东西：一个专用的 Ethereum 钱包，其中有少量 Base 网络上的 USDC（主网，eip155:8453——几美分就足以测试；支付中介会代付 Gas，你只需要准备 USDC），以及一个支持 MCP 的客户端。选择你的客户端：

⚠️ 以下所有选项都会将密钥以纯文本形式保存在配置文件或命令中。切勿将该文件（或包含密钥的命令）放入 git 仓库，也不要将其保存在共享或同步的 shell 历史记录中——密钥一旦泄露，任何人都能直接访问你的钱包，完全不需要 MCP 服务。

Claude Desktop

编辑（或创建）~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "agentum": {
      "command": "npx",
      "args": ["-y", "@agentum/mcp-server"],
      "env": {
        "AGENTUM_MCP_WALLET_KEY": "0xSUACHAVEPRIVADAAQUI"
      }
    }
  }
}

重启 Claude Desktop。完成——例如询问“检查 CNPJ 68964713000109”，Claude 就会自行调用工具。

Claude Code（CLI）

直接在命令中输入密钥，会将其以纯文本形式写入 ~/.zsh_history/~/.bash_history（许多 dotfiles 配置会在你未察觉时同步或版本控制此文件）。请使用 read -s——它不会回显你输入或粘贴的内容，而且 shell 会将命令按输入内容原样（包含字面量 $AGENTUM_MCP_WALLET_KEY），而不是替换后的值，写入历史记录：

read -s -p "Cole sua chave privada (0x...): " AGENTUM_MCP_WALLET_KEY && echo
export AGENTUM_MCP_WALLET_KEY
claude mcp add agentum -e AGENTUM_MCP_WALLET_KEY=$AGENTUM_MCP_WALLET_KEY -- npx -y @agentum/mcp-server

（-e/--env 必须放在 -- 之前；-- 之后的所有内容都会原样传递给服务。）

Cursor

建议使用 ~/.cursor/mcp.json（适用于所有项目，且不会放在 git 仓库内）。只有在确保首次提交前已将 .cursor/ 加入 .gitignore 的情况下，才使用项目内的版本（.cursor/mcp.json）—— 密钥一旦进入 git 历史，之后删除文件也无法解决问题（它仍保留在历史记录中；需要使用 git filter-repo 或类似工具重写历史）。

{
  "mcpServers": {
    "agentum": {
      "command": "npx",
      "args": ["-y", "@agentum/mcp-server"],
      "env": {
        "AGENTUM_MCP_WALLET_KEY": "0xSUACHAVEPRIVADAAQUI"
      }
    }
  }
}

切勿使用还存有重要资金的钱包——请使用专用钱包，仅存放满足你预期用途所需的 USDC。

完整实际示例

给 Agent 的提示词：“检查 CNPJ 68964713000109”

Agent 会自行决定调用 verificar_cnpj({ cnpj: "68964713000109" }) ——服务会在 Base 上签署一笔真实的 $0.02 USDC 支付，AGENTUM 处理后返回结果，Agent 随即收到（真实的生产数据）：

{
  "cnpj": "68.964.713/0001-09",
  "razao_social": "AGENTUM LTDA",
  "situacao": "ATIVA",
  "data_situacao": "03/09/2026",
  "abertura": "03/09/2026",
  "natureza_juridica": "206-2 - Sociedade Empresária Limitada",
  "uf": "SP",
  "municipio": "SERTAOZINHO",
  "atividade_principal": "Desenvolvimento e licenciamento de programas de computador customizáveis",
  "fonte": "receitaws"
}

你无需编写任何支付代码——服务会自行处理 x402 挑战、签名和安全检查（见下文“安全”一节）。

可用工具

工具	价格	描述
`verificar_cnpj`	$0.02	注册状态、Simples Nacional、地址
`taxas_brasil`	$0.01	Selic、CDI、商业美元汇率（Banco Central）
`verificar_cep`	$0.01	根据 CEP 查询完整地址
`validar_cpf`	$0.01	校验校验位（不查询个人数据）
`business_intelligence`	$0.05	完整 CNPJ + 合伙人 + AI 生成的摘要
`fx_rates`	$0.01	官方汇率（Banco Central Europeu），支持任意货币对
`economic_data`	$0.01	GDP、通胀、失业率、人口（Banco Mundial），支持任意国家
`vat_validate`	$0.01	实时验证欧洲 VAT（VIES，欧盟官方）
`company_enrich`	$0.01	通过 LEI（GLEIF）识别全球企业，支持任意国家
`company_intelligence_br`	$0.02	CNPJ + 合规信息（TCU、CNJ、CEIS、CNEP、CVM）——仅提供事实，不含评分
`preflight`	$0.15	交易对手判定（CNPJ、LEI 或名称）——等级为 clear/flagged/insufficient_data，不会捏造评分

company_intelligence_br 和 preflight 使用与其他工具不同的收款钱包（AGENTUM Business 系统，进程/域名特意分开）——服务端已了解这一点，并会针对对应的收款钱包验证每条路由。

从源代码运行（开发）

如果你克隆了此仓库，而不是使用已发布的软件包（npx），配置会指向本地文件，而不会让 npx 解析：

npm install
read -s -p "Cole sua chave privada (0x...): " AGENTUM_MCP_WALLET_KEY && echo
export AGENTUM_MCP_WALLET_KEY

（直接输入 export VAR=0x... 会将内容以纯文本形式保存在 shell 历史记录中——使用 read -s 可避免这种情况，参见上方的 Quick Start 提示。）

{
  "mcpServers": {
    "agentum": {
      "command": "node",
      "args": ["/caminho/completo/pra/mcp-server/index.js"],
      "env": {
        "AGENTUM_MCP_WALLET_KEY": "0xSUACHAVEPRIVADAAQUI"
      }
    }
  }
}

安全性

在签署任何付款前，服务端会核实 AGENTUM 返回的收费信息是否完全符合以下条件：Base 主网、USDC 资产、收款方为 AGENTUM 官方钱包，且金额不超过该特定路由的已知上限。任何不符合条件的情况都会导致调用中止，且不会签署任何内容——即使 AGENTUM 服务端遭到入侵或存在 bug，你的钱包也绝不会向其他收款方付款，或支付超出预期的金额。

你的私钥不会离开本地计算机/进程——不会发送给 AGENTUM 或任何其他人，只会在本地签署 x402 付款授权。