Brazilayer: Brazilian Public Data

pedagio-mcp：MCP サーバー

一般公開版： このサーバーは github.com/brazilayer/mcp で公開されています。 （エンドユーザー向けのインストール方法もこちらにあります）。このフォルダーは内部ソースです。ここでの変更は 公開リポジトリにも反映する必要があります。

pedagio 公開 API（SPEC §8）のシンクライアントです。CNPJ データを x402 経由で支払い可能な MCP ツールとして公開します。データベースへの直接アクセスはなく、各ツールが HTTP API を呼び出し、設定済みのウォレットを使って USDC（Base ネットワーク）で支払います。

ツール

ツール	エンドポイント	価格
cnpj_consultar_empresa	GET /v1/cnpj/empresa/{cnpj}	0.005 米ドル
cnpj_listar_socios	GET /v1/cnpj/empresa/{cnpj}/socios	0.005 米ドル
cnpj_consultar_empresa_completo	GET /v1/cnpj/empresa/{cnpj}/completo	0.01 米ドル
cnpj_buscar_empresas	GET /v1/cnpj/busca	0.01 米ドル
cnpj_buscar_por_socio	GET /v1/cnpj/socio/busca	0.02 米ドル
cnpj_obter_amostra	GET /v1/cnpj/amostra	無料
trust_check	支払い前に任意の x402 サービスの信頼性を評価します（Agent Economy Report、無料）	無料
skill_check	インストール前に任意のエージェントスキルの信頼性を評価します（Agent Economy Report、無料）	無料
conduct_check	委任前に任意の AI エージェントまたはフレームワークの行動を評価します（Agent Economy Report アリーナ、無料）	無料

インストール（Claude Code）

git clone https://github.com/aladaf/pedagio && cd pedagio/mcp && npm install
claude mcp add pedagio -e BRAZILAYER_PRIVATE_KEY=0xSUACHAVE -- npx tsx /caminho/para/pedagio/mcp/servidor.ts

インストール（Claude Desktop / Cursor）

{
  "mcpServers": {
    "pedagio": {
      "command": "npx",
      "args": ["tsx", "/caminho/para/pedagio/mcp/servidor.ts"],
      "env": {
        "BRAZILAYER_PRIVATE_KEY": "0xCHAVE_DA_CARTEIRA_QUE_PAGA"
      }
    }
  }
}

環境変数

• BRAZILAYER_API_URL：デフォルトは https://api.brazilayer.com
• BRAZILAYER_PRIVATE_KEY：呼び出しの支払いに使用するウォレットの秘密鍵（0x…） （Base ネットワーク上の USDC が必要です。テストネットでは Base Sepolia の faucet から入手した USDC を使用します）。設定しない場合、 cnpj_obter_amostra のみ動作し、それ以外は 402 エラーの理由を説明します。

⚠️ ここで設定する鍵は実際の支払いに署名します。残高の少ない専用ウォレットを使用してください。

x402↔MCP 統合方式の選択（SPEC §8）

2026-07-20 に評価し、公式パッケージ @x402/fetch + @x402/evm （v2.19）を採用しました。これらは fetch を 402→署名→再試行のフローでラップし、MCP サーバーは各ツールで この支払い対応の fetch を使用します。サードパーティー製の MCP ブリッジは、公式 SDK より保守状況がよくないため、採用を見送りました。

---

エージェントエコノミーを構築していますか？ 私たちは Agent Economy Report を公開しています。これは、マシン間経済（x402 サービス、オンチェーン決済、MCP、ペイドウェブの普及状況）を対象とする、データ生成型の週刊インデックスです。メールは週に 1 通です。