English Français العربية

Brazilayer: Brazilian Public Data

السجل الرسمي الذكاء الاصطناعي والوكلاء

Brazilian company registry (CNPJ), sanctions, funds & market data for AI agents, paid via x402.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

MCPB package https://github.com/brazilayer/mcp/releases/download/v0.15.2/brazilayer-mcp.mcpb

متغيرات البيئة

  • BRAZILAYER_PRIVATE_KEY سري Private key (0x…) of the wallet that pays for calls (USDC on Base). Optional: without it, only the free sample tools work.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. pedagio-mcp: servidor MCP
  2. Ferramentas
  3. Instalação (Claude Code)
  4. Instalação (Claude Desktop / Cursor)
  5. Variáveis
  6. Escolha da integração x402↔MCP (SPEC §8)

pedagio-mcp: servidor MCP

Distribuição pública: este servidor é publicado em github.com/brazilayer/mcp (instalação para usuários finais lá). Esta pasta é a fonte interna; alterações aqui devem ser espelhadas no repo público.

Cliente fino da API pública do pedagio (SPEC §8): expõe os dados de CNPJ como ferramentas MCP pagáveis via x402. Sem acesso direto ao banco: cada ferramenta chama a API HTTP e paga com USDC (rede Base) usando a carteira configurada.

Ferramentas

FerramentaEndpointPreço
cnpj_consultar_empresaGET /v1/cnpj/empresa/{cnpj}US$ 0.005
cnpj_listar_sociosGET /v1/cnpj/empresa/{cnpj}/sociosUS$ 0.005
cnpj_consultar_empresa_completoGET /v1/cnpj/empresa/{cnpj}/completoUS$ 0.01
cnpj_buscar_empresasGET /v1/cnpj/buscaUS$ 0.01
cnpj_buscar_por_socioGET /v1/cnpj/socio/buscaUS$ 0.02
cnpj_obter_amostraGET /v1/cnpj/amostragrátis
trust_checkTrust rating of any x402 service before paying it (Agent Economy Report, free)free
skill_checkTrust rating of any agent skill before installing it (Agent Economy Report, free)free
conduct_checkConduct rating of any AI agent or framework before delegating to it (Agent Economy Report arena, free)free

Instalação (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

Instalação (Claude Desktop / Cursor)

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

Variáveis

  • BRAZILAYER_API_URL: default https://api.brazilayer.com
  • BRAZILAYER_PRIVATE_KEY: chave privada (0x…) da carteira que paga as chamadas (precisa de USDC na rede Base; na testnet, USDC de faucet na Base Sepolia). Sem ela, apenas cnpj_obter_amostra funciona; as demais explicam o 402.

⚠️ A chave configurada aqui assina pagamentos reais. Use uma carteira dedicada com saldo pequeno.

Escolha da integração x402↔MCP (SPEC §8)

Avaliado em 2026-07-20: adotados os pacotes oficiais @x402/fetch + @x402/evm (v2.19), que envelopam o fetch com o fluxo 402→assinatura→retry, e o servidor MCP usa esse fetch pagante em cada ferramenta. Alternativas de bridge MCP de terceiros foram descartadas por serem menos mantidas que o SDK oficial.

Building on the agent economy? We publish the Agent Economy Report, a free weekly, data-generated index of the machine-to-machine economy (x402 services, on-chain settlement, MCP and paid-web adoption). One e-mail a week.

الأسئلة الشائعة

ما هو Brazilayer: Brazilian Public Data؟

Brazilian company registry (CNPJ), sanctions, funds & market data for AI agents, paid via x402.

كيف أثبّت Brazilayer: Brazilian Public Data؟

اتبع خطوات التثبيت في توثيقه المعروض في هذه الصفحة وفي مستودعه.

هل يحتاج Brazilayer: Brazilian Public Data إلى مفتاح API؟

نعم. يتطلب BRAZILAYER_PRIVATE_KEY، وتضبطها في إعداداته.

هل Brazilayer: Brazilian Public Data مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Brazilayer: Brazilian Public Data؟

ينشره brazilayer. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.