
grid402
io.github.oliveiratc/grid402
24 MCP tools: Brazil CNPJ, compliance, ANBIMA, FX, GLEIF LEI, OFAC & DNS/SSL via x402 Base USDC.
Documentation
Grid402 // The Verifiable Data and x402 Payment Layer for Autonomous AI Agents
The Verifiable Data and x402 Payment Layer for Autonomous AI Agents. Infraestrutura M2M de dados públicos verificáveis com assinatura ECDSA secp256k1 (
_oracle_proof) e liquidação instantânea via HTTP x402 (USDC na rede Base) ou Session Passes pré-pagos sub-15ms.
⚡ Destaques da Arquitetura
- Monetização Nativa via HTTP x402 (v2 Exact): Cobrança por chamada (0.0050 a 0.0300 USDC) liquidada diretamente em USDC na rede Base (Chain ID 8453) via autorizações gasless EIP-3009 (
PAYMENT-SIGNATURE), Session Passes pré-pagos ou transferências on-chain, sem necessidade de chaves de API estáticas. - Amostras Gratuitas no HTTP 402 (Teaser Data): O desafio 402 inclui uma prévia segura dos dados públicos encontrados (ex: razão social, município e UF no CNPJ; logradouro e bairro no CEP; status TLS no SSL) antes da liquidação financeira.
- Modo Sandbox para Testes e CI/CD: Permite simulação técnica via cabeçalho
X-Payment: demo(cota defensiva por IP), facilitando desenvolvimento local e pipelines de homologação antes de operar em produção. - Zero Banco de Dados (Zero-DB): Arquitetura ultraleve baseada em arquivos JSON planos com travamento concorrente (
flock) e escrita atômica (grid402_atomic_write), sem sobrecarga de conexões SQL. - Distribuição Smithery.ai: Manifesto
smithery.yamlna raiz para instalação e configuração em 1 clique em clientes MCP como Claude Desktop e Cursor. - Coinbase Developer Platform (CDP) AgentKit: Provedor de ações pronto em TypeScript e Python (
integrations/agentkit/) para auto-liquidação M2M por agentes autônomos baseados em LangChain e CrewAI. - Interface Adaptativa: Respostas JSON limpas para agentes de IA e clientes M2M, e portal web responsivo em modo escuro com console interativo para desenvolvedores.
🛠️ Catálogo de Serviços Disponíveis
| Serviço | Rota da API | Custo M2M | Descrição Técnica |
|---|---|---|---|
| Resumo Operacional | GET /status | Gratuito | Saúde geral, latências médias, uptime 30d e 22 serviços operantes |
| Câmbio Comercial | GET /api/v1/forex | 0.0050 USDC (1 crédito) | Cotações em tempo real de USD, EUR e GBP para BRL |
| Preços Cripto | GET /api/v1/crypto | 0.0050 USDC (1 crédito) | Cotações spot e variação 24h de BTC, ETH, SOL, USDC e BASE |
| Resolução DNS | GET /api/v1/dns?domain=... | 0.0050 USDC (1 crédito) | Registros A, AAAA, MX, TXT, NS e CNAME com latência |
| Inspetor SSL/TLS | GET /api/v1/ssl?host=... | 0.0050 USDC (1 crédito) | Emissor, validade, dias restantes e cipher suite |
| Inteligência ASN | GET /api/v1/asn?ip=... | 0.0050 USDC (1 crédito) | BGP, número ASN, organização detentora e país |
| Auditoria de Domínio | GET /api/v1/domain-audit?domain=... | 0.0150 USDC (3 créditos) | Bundle consolidado DNS + TLS/SSL + BGP/ASN em chamada única |
| Dossiê KYB Audit | GET /api/v1/kyb-audit?cnpj=... | 0.0200 USDC (4 créditos) | Dossiê corporativo unificado: CNPJ + Simples + Sanções + Score 360 |
| Market Snapshot | GET /api/v1/market-snapshot | 0.0150 USDC (3 créditos) | Panorama macro e financeiro: Câmbio + Cripto + Selic/CDI/IPCA + ANBIMA |
| Consulta Postal CEP | GET /api/v1/cep?code=... | 0.0050 USDC (1 crédito) | Logradouro, bairro, cidade, UF e código IBGE oficial |
| Consulta CNPJ | GET /api/v1/cnpj?cnpj=... | 0.0200 USDC (4 créditos) | Razão social, status cadastral, CNAE e dados da Receita Federal |
| Indicadores BCB/IBGE | GET /api/v1/indicators | 0.0050 USDC (1 crédito) | Taxas oficiais Selic, CDI e IPCA acumulado 12m |
| Feriados Nacionais | GET /api/v1/holidays?year=... | 0.0050 USDC (1 crédito) | Calendário nacional e bancário ANBIMA/Febraban |
| Dias Úteis ANBIMA | GET /api/v1/workdays | 0.0050 USDC (1 crédito) | Contagem e projeção de vencimentos D+N bancários |
| Sanções CEIS/CNEP | GET /api/v1/sanctions?cnpj=... | 0.0100 USDC (2 créditos) | Checagem de inidoneidade e punições administrativas na CGU |
| Simples Nacional e MEI | GET /api/v1/simples?cnpj=... | 0.0100 USDC (2 créditos) | Enquadramento tributário Simples Nacional e SIMEI |
| Compliance Score 360 | GET /api/v1/compliance?cnpj=... | 0.0300 USDC (6 créditos) | Score de risco corporativo de 0 a 100 cruzando RF e CGU |
| Identidade Global LEI | GET /api/v1/lei?lei=... | 0.0200 USDC (4 créditos) | Registro corporativo global ISO 17442 via GLEIF (200+ jurisdições) |
| Sanções OFAC e AML | GET /api/v1/ofac?target=... | 0.0200 USDC (4 créditos) | Triagem OFAC SDN, ONU e risco AML Web3 na Base Mainnet |
| Notarização SHA-256 | GET /api/v1/notarize?content=... | 0.0050 USDC (1 crédito) | Carimbo do tempo criptográfico e prova de existência ECDSA |
| Mercados Globais e BCE | GET /api/v1/global-markets | 0.0050 USDC (1 crédito) | Calendário US/EU/UK/BR e 30+ taxas de câmbio do BCE |
| Session Pass x402 | GET /api/v1/pass | 2 / 5 / 20 USDC | Emissão de passe pré-pago de sub-15ms (400 / 1.000 / 6.000 créditos) |
| Saldo do Session Pass | GET /api/v1/pass/balance | Gratuito | Consulta gratuita de créditos restantes, validade e Spend Controls |
| Verificador de Prova | POST /api/v1/verify | Gratuito | Verificação matemática stateless da assinatura _oracle_proof |
🤖 Formas de Integração para Agentes de IA
1. Servidor MCP via Smithery.ai (Claude Desktop e Cursor)
Instalação automática em 1 clique via CLI do Smithery:
# Para Claude Desktop
npx -y @smithery/cli install grid402-mcp --client claude
# Para Cursor
npx -y @smithery/cli install grid402-mcp --client cursor
2. Provedor de Ações Coinbase AgentKit (M2M Auto-Settlement)
Para agentes autônomos que operam na Base com carteiras CDP:
import { AgentKit, CdpWalletProvider } from "@coinbase/agentkit";
import { Grid402ActionProvider } from "./integrations/agentkit/grid402_action_provider";
const walletProvider = await CdpWalletProvider.configureWithWallet();
const agentKit = await AgentKit.from({
walletProvider,
actionProviders: [new Grid402ActionProvider()]
});
Exemplos detalhados em TypeScript e Python disponíveis em integrations/agentkit/README.md.
3. Plugin Oficial para ElizaOS (grid402-plugin-elizaos)
Para agentes autônomos no framework ElizaOS:
import { grid402Plugin } from "grid402-plugin-elizaos";
export const character = {
name: "CryptoComplianceAgent",
plugins: [grid402Plugin],
settings: {
secrets: {
GRID402_PASS_TOKEN: "pass_g402_live..._..." // Adquira em https://grid402.online/#topup
}
}
};
Exemplos detalhados e guia de instalação disponíveis em integrations/elizaos/README.md.
4. Recarga Web3 em 1 Clique (Session Passes na Base)
Para agentes e desenvolvedores que buscam alta frequência (abaixo de 15ms) sem o custo e atrito de assinar 1 transação a cada GET:
- Acesse a interface web em https://grid402.online/#topup
- Conecte sua carteira (MetaMask, Coinbase Smart Wallet com Passkey, Rainbow) na rede Base
- Selecione seu pacote (
1 crédito = 0.0050 USDC/ 1 chamada padrão):- Starter: 2 USDC / R$ 12 $\rightarrow$ 400 créditos (= 400 chamadas padrão, validade 30 dias)
- Pro: 5 USDC / R$ 29 $\rightarrow$ 1.000 créditos (= 1.000 chamadas padrão, validade 30 dias)
- Fleet: 20 USDC / R$ 115 $\rightarrow$ 6.000 créditos (5.000 + 1.000 bônus = 6.000 chamadas padrão, validade 60 dias)
- Receba instantaneamente seu token
pass_g402_live...para usar no cabeçalhoX-Payment, consulte o saldo gratuitamente emGET /api/v1/pass/balancee envieIdempotency-Key: <uuid>para retentativas seguras sem débito duplicado.
5. Dossiê Institucional Base Grants e Coinbase CDP
O plano de crescimento, métricas de rede e candidatura formal a subsídios da Base Foundation e Coinbase Developer Platform estão detalhados em docs/BASE_GRANTS_AND_CDP_DOSSIER.md.
6. Chamadas Diretas via cURL
Consulta com Desafio HTTP 402 e Amostra Gratuita:
curl -i "https://grid402.online/api/v1/cnpj?cnpj=00000000000191"
Liquidação On-Chain na Base:
curl "https://grid402.online/api/v1/cnpj?cnpj=00000000000191" \
-H "X-Payment: 0x<tx_hash_da_transferencia_na_base>"
Modo Sandbox Gratuito para Testes:
curl "https://grid402.online/api/v1/cnpj?cnpj=00000000000191" \
-H "X-Payment: demo"
📁 Estrutura de Arquivos
├── .env.example # Modelo de variáveis de ambiente
├── smithery.yaml # Manifesto oficial para o registro Smithery.ai
├── PRD.md # Documento de Requisitos do Produto
├── README.md # Este guia completo do projeto
├── integrations/ # Integrações para frameworks de IA
│ └── agentkit/ # Provedor de ações Coinbase Developer Platform (CDP)
│ ├── grid402_action_provider.ts # Implementação TypeScript para @coinbase/agentkit
│ ├── grid402_action_provider.py # Implementação Python para cdp-agentkit-core
│ └── README.md # Guia de uso para LangChain e CrewAI
├── mcp/ # Pacote oficial Model Context Protocol (grid402-mcp)
│ ├── package.json # Configuração e dependências do servidor MCP
│ ├── index.mjs # Ponto de entrada do protocolo MCP
│ ├── tools.mjs # Implementação das 24 ferramentas MCP e cliente HTTP x402
│ ├── test_mcp.mjs # Suíte de testes automatizados do MCP
│ └── README.md # Documentação de configuração do servidor MCP
├── public_html/ # Raiz pública servida na Hostinger
│ ├── index.php # Porteiro x402, roteador da API e portal interativo
│ ├── config.php # Definições, alvos, provedores e carregador .env
│ ├── x402.php # Validador on-chain Base e verificação de recibos
│ ├── openapi.json # Especificação OpenAPI 3.1
│ ├── llms.txt # Manifesto de descoberta para modelos de linguagem
│ └── private_data/ # Armazenamento protegido (Zero-DB)
│ ├── summary_free.json # Cache público do resumo operacional
│ ├── telemetry_paid.json # Dados consolidados dos serviços
│ ├── sandbox_usage.json # Controle de limites por IP no Sandbox
│ └── used_txs.json # Registro de transações já liquidadas
└── tests/ # Suíte de testes automatizados locais
├── test_teaser_preview.php # Teste de validação de amostras no HTTP 402
├── test_sandbox_mode.php # Teste de validação do Modo Sandbox
└── test_agentkit_integration.php # Teste de conformidade Smithery e AgentKit
🧪 Testes Automatizados Locais
Para executar os testes com PHP 8.1+ e Node.js:
# 1. Testes de Amostra de Dados (Teaser)
php tests/test_teaser_preview.php
# 2. Testes de Modo Sandbox
php tests/test_sandbox_mode.php
# 3. Testes do Servidor MCP
node mcp/test_mcp.mjs
🔐 Segurança Não-Custodial e Gestão de Chaves M2M
- Zero Custódia de Chaves de Agentes: O gateway servidor nunca solicita nem armazena chaves privadas ou seed phrases de clientes.
- Carteiras Isoladas de Orçamento (Agentes Autônomos): Ao utilizar
GRID402_PRIVATE_KEYnogrid402-mcpou Coinbase AgentKit, utilize sempre uma carteira operacional dedicada com saldo estritamente limitado ao orçamento de automação (injetada via.envou cofre de segredos, jamais versionada no Git). - Session Pass com Spend Controls: Para eliminar qualquer exposição de chave privada no runtime do agente, emita um
pass_g402_...e configuredaily_credit_limiteallowed_endpointscom acompanhamento viaGET /api/v1/pass/balance.
📄 Licenciamento (Dual-License) e Propriedade Intelectual
O ecossistema Grid402 adota separação explícita de licenças para garantir liberdade total de adoção nos clientes de IA e proteção da infraestrutura proprietária:
| Camada / Diretório | Licença Aplicável | Escopo |
|---|---|---|
SDKs, MCP Server e Integrações (python/, mcp/, sdk/, integrations/, examples/) | MIT License | Uso livre, comercial ou aberto, em agentes autônomos, forks clientes e produtos SaaS (PyPI grid402, npm grid402-mcp) |
Gateway e Plataforma Servidora (public_html/) | Proprietária (All Rights Reserved) | Motor HTTP x402, assinador ECDSA do Oráculo, Session Pass, interface web e painel administrativo (Lei nº 9.609/1998 e Lei nº 9.610/1998) |
| Dados Consultados nas APIs | Domínio Público / CC0 / LAI | Registros governamentais abertos e protocolos IETF sem reserva proprietária |
© 2026 Grid402 Network Intelligence. Consulte LICENSE e llms.txt para os termos completos.
No installation packages available.