grid402-mcp 1.7.0 → 1.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,26 +1,39 @@
1
1
  # grid402-mcp ⚡
2
2
 
3
- Servidor oficial do **Model Context Protocol (MCP)** para o **Grid402** — Hub de Utilitários de Rede e Dados Públicos Abertos com liquidação de micropagamentos x402 em USDC na rede Base.
3
+ Servidor oficial do **Model Context Protocol (MCP)** para o **Grid402** — Hub de 23 Micro-Serviços de Dados Públicos Abertos e Utilitários de Rede (25 ferramentas MCP) com liquidação de micropagamentos x402 em USDC Multi-Chain (Base, Arbitrum, Polygon, Optimism, Ethereum e Solana SPL).
4
4
 
5
- Compatível nativamente com **Claude Desktop**, **Cursor**, **Smithery.ai**, **Coinbase AgentKit** e qualquer orquestrador compatível com a especificação MCP da Anthropic.
5
+ Compatível nativamente com **Claude Desktop**, **Cursor**, **Smithery.ai**, **Glama**, **Coinbase AgentKit** e qualquer orquestrador compatível com a especificação MCP da Anthropic.
6
6
 
7
7
  ---
8
8
 
9
- ## 🛠️ Ferramentas Disponíveis
9
+ ## 🛠️ Ferramentas Disponíveis (25 Tools)
10
10
 
11
11
  | Ferramenta | Descrição | Modalidade | Custo |
12
12
  |---|---|---|---|
13
- | `grid402_summary` | Resumo consolidado de saúde dos serviços | Direto | Gratuito |
14
- | `grid402_forex` | Cotações em tempo real de USD, EUR e GBP para BRL | On-Demand | 0.0005 USDC |
15
- | `grid402_crypto` | Preços spot de BTC, ETH, SOL, USDC e BASE | On-Demand | 0.0005 USDC |
16
- | `grid402_dns` | Resolução autoritativa de DNS (A, AAAA, MX, TXT, NS, CNAME) | On-Demand | 0.0005 USDC |
17
- | `grid402_ssl` | Inspeção de validade, emissor e dias restantes de certificados TLS/SSL | On-Demand | 0.0005 USDC |
18
- | `grid402_asn` | Inteligência BGP, número ASN, organização e país de bloco IP | On-Demand | 0.0005 USDC |
19
- | `grid402_cep` | Consulta de endereço postal brasileiro e código IBGE oficial | On-Demand | 0.0005 USDC |
20
- | `grid402_cnpj` | Consulta cadastral de CNPJ da Receita Federal com status e CNAE | On-Demand | 0.0020 USDC |
21
- | `grid402_indicators` | Indicadores macroeconômicos oficiais (Selic meta e diária, CDI anual e IPCA) | On-Demand | 0.0005 USDC |
22
- | `grid402_holidays` | Calendário oficial de feriados nacionais e bancários ANBIMA por ano | On-Demand | 0.0005 USDC |
23
- | `grid402_workdays` | Calculadora de dias úteis financeiros e projeção de vencimentos ANBIMA | On-Demand | 0.0005 USDC |
13
+ | `grid402_summary` | Resumo consolidado de saúde dos 23 serviços | Direto | Gratuito |
14
+ | `grid402_forex` | Cotações em tempo real de USD, EUR e GBP para BRL | On-Demand | 0.0050 USDC (1 cr) |
15
+ | `grid402_crypto` | Preços spot de BTC, ETH, SOL, USDC e BASE | On-Demand | 0.0050 USDC (1 cr) |
16
+ | `grid402_dns` | Resolução autoritativa de DNS (A, AAAA, MX, TXT, NS, CNAME) | On-Demand | 0.0050 USDC (1 cr) |
17
+ | `grid402_ssl` | Inspeção de validade, emissor e dias restantes de certificados TLS/SSL | On-Demand | 0.0050 USDC (1 cr) |
18
+ | `grid402_asn` | Inteligência BGP, número ASN, organização e país de bloco IP | On-Demand | 0.0050 USDC (1 cr) |
19
+ | `grid402_domain_audit` | Bundle consolidado de domínio (DNS + TLS/SSL + BGP/ASN) | On-Demand | 0.0150 USDC (3 cr) |
20
+ | `grid402_kyb_audit` | Auditoria global KYB em 1 chamada (Receita Federal CNPJ + OFAC/ONU + GLEIF LEI) | On-Demand | 0.0200 USDC (4 cr) |
21
+ | `grid402_get_dossier_360` | Dossiê 360º KYB Premium com Veredito IA (APPROVED/FLAGGED/REJECTED), RFB, Simples/MEI e CGU CEIS/CNEP | On-Demand | 0.0500 USDC (10 cr) |
22
+ | `grid402_market_snapshot` | Panorama macro consolidado (Câmbio + Cripto + Selic/CDI/IPCA + ANBIMA) | On-Demand | 0.0150 USDC (3 cr) |
23
+ | `grid402_cep` | Consulta de endereço postal brasileiro e código IBGE oficial | On-Demand | 0.0050 USDC (1 cr) |
24
+ | `grid402_cnpj` | Consulta cadastral de CNPJ da Receita Federal com status e CNAE | On-Demand | 0.0200 USDC (4 cr) |
25
+ | `grid402_indicators` | Indicadores macroeconômicos oficiais (Selic meta e diária, CDI anual e IPCA) | On-Demand | 0.0050 USDC (1 cr) |
26
+ | `grid402_holidays` | Calendário oficial de feriados nacionais e bancários ANBIMA por ano | On-Demand | 0.0050 USDC (1 cr) |
27
+ | `grid402_workdays` | Calculadora de dias úteis financeiros e projeção de vencimentos ANBIMA | On-Demand | 0.0050 USDC (1 cr) |
28
+ | `grid402_sanctions` | Checagem de sanções administrativas nos cadastros CEIS e CNEP da CGU | On-Demand | 0.0100 USDC (2 cr) |
29
+ | `grid402_simples` | Enquadramento tributário oficial no Simples Nacional e MEI (SIMEI) | On-Demand | 0.0100 USDC (2 cr) |
30
+ | `grid402_compliance` | Compliance Score 360 (0 a 100) cruzando Receita Federal e CGU | On-Demand | 0.0300 USDC (6 cr) |
31
+ | `grid402_lei` | Identidade corporativa global ISO 17442 via GLEIF (200+ jurisdições) | On-Demand | 0.0200 USDC (4 cr) |
32
+ | `grid402_ofac` | Triagem OFAC SDN / ONU e risco AML Web3 na Base Mainnet | On-Demand | 0.0200 USDC (4 cr) |
33
+ | `grid402_notarize` | Carimbo do tempo criptográfico SHA-256 e prova de existência ECDSA | On-Demand | 0.0050 USDC (1 cr) |
34
+ | `grid402_global_markets` | Calendário de bolsas (US/EU/UK/BR) e 30+ taxas de câmbio do BCE | On-Demand | 0.0050 USDC (1 cr) |
35
+ | `grid402_pass` | Emissão de Session Pass pré-pago (Starter 400 cr / Pro 1.000 cr / Fleet 6.000 cr) | Pré-Pago | 2 / 5 / 20 USDC |
36
+ | `grid402_pass_balance` | Consulta de saldo, validade e Spend Controls de um Session Pass | Direto | Gratuito |
24
37
  | `grid402_verify` | Validação matemática de prova criptográfica de oráculo (_oracle_proof) secp256k1 | Direto | Gratuito |
25
38
 
26
39
  ---
@@ -58,14 +71,17 @@ Adicione ao seu arquivo de configuração (`claude_desktop_config.json`):
58
71
  "env": {
59
72
  "GRID402_ENDPOINT": "https://grid402.online",
60
73
  "GRID402_SANDBOX": "false",
61
- "GRID402_PRIVATE_KEY": "0xsua_chave_privada_base_aqui"
74
+ "GRID402_SESSION_PASS": "pass_g402_seu_passe_aqui_opcional",
75
+ "GRID402_PRIVATE_KEY": "0xsua_chave_privada_base_aqui_opcional"
62
76
  }
63
77
  }
64
78
  }
65
79
  }
66
80
  ```
67
81
 
68
- > 💡 **Modo Sandbox Gratuito:** Você pode definir `"GRID402_SANDBOX": "true"` para testar todas as ferramentas sem gastar USDC nem configurar chave privada (limite de 20 consultas por hora por IP).
82
+ > 💡 **Modo Sandbox Gratuito:** Você pode definir `"GRID402_SANDBOX": "true"` para testar todas as ferramentas sem gastar USDC nem configurar chave privada (limite de 5 consultas por hora por IP).
83
+ >
84
+ > 💡 **Session Pass (Sem Chave Privada):** Se preferir não informar `GRID402_PRIVATE_KEY`, adquira um passe pré-pago em `https://grid402.online/#topup` e defina `"GRID402_SESSION_PASS": "pass_g402_..."` para execução em `<15ms`.
69
85
  >
70
86
  > 💡 **Nota de Segurança:** A variável `GRID402_PRIVATE_KEY` é opcional. Se informada, o servidor MCP realiza a transferência automática de USDC on-chain na Base a cada consulta paga. Se não informada ou sem saldo, o servidor retorna o desafio x402 com amostra de dados. A chave é processada estritamente na sua máquina local e nunca é enviada ao servidor do Grid402.
71
87
 
@@ -104,7 +120,7 @@ O provedor gerencia automaticamente o ciclo de vida HTTP 402, transferindo os mi
104
120
 
105
121
  ## 🛡️ Prova Criptografica de Oraculo (Proof of Data)
106
122
 
107
- Todas as ferramentas pagas e em sandbox retornam o bloco `_oracle_proof` com garantia matematica de integridade e assinatura ECDSA secp256k1 emitida pela carteira oficial do Grid402 (`0xa31c31069c43ac1c0075a93c325b0dcd7744356c`). Isso permite que agentes validem que os dados consumidos sao legitimos e nao sofreram alteracao durante o trânsito.
123
+ Todas as ferramentas pagas e em sandbox retornam o bloco `_oracle_proof` com garantia matematica de integridade e assinatura ECDSA secp256k1 emitida pela carteira oficial do Grid402 (`0xa592625adbceb8e025ac383f1a3fd8ebb6a63f90`). Isso permite que agentes validem que os dados consumidos sao legitimos e nao sofreram alteracao durante o trânsito.
108
124
 
109
125
  ---
110
126
 
package/index.mjs CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  /**
4
4
  * Grid402 Official Model Context Protocol (MCP) Server
5
- * Exposes 7 tools for real-time open data and network utilities with Base x402 settlement.
5
+ * Exposes 25 tools for real-time open data and M2M network utilities with Multi-Chain x402 USDC settlement.
6
6
  */
7
7
 
8
8
  import { Server } from '@modelcontextprotocol/sdk/server/index.js';
@@ -10,15 +10,23 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
10
10
  import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
11
11
  import { MCP_TOOLS_DEFINITIONS, executeGrid402Request, DEFAULT_ENDPOINT } from './tools.mjs';
12
12
 
13
+ export const GRID402_MCP_INSTRUCTIONS = [
14
+ 'Grid402 is a verifiable public-data and network utility M2M oracle settled via HTTP x402 (USDC across Base, Arbitrum, Polygon, Optimism, Ethereum, and Solana SPL).',
15
+ 'Tool selection: use free tools first (`grid402_summary` for 23-service health, `grid402_pass_balance` for prepaid pass quota/spend-controls, `grid402_verify` for offline-equivalent ECDSA secp256k1 proof verification). Prefer composite bundles (`grid402_domain_audit`, `grid402_kyb_audit`, `grid402_get_dossier_360`, `grid402_market_snapshot`) over multiple separate calls to reduce cost and latency.',
16
+ 'Authentication and Payment modes: (1) Set `GRID402_SANDBOX=true` for free sandbox testing via `X-Payment: demo` (5 queries/hour per IP); (2) Set `GRID402_SESSION_PASS=pass_g402_...` for <15ms prepaid calls (`1 credit = 0.0050 USDC`, zero per-call gas); (3) Set `GRID402_PRIVATE_KEY` using a dedicated low-balance operational Base wallet for automatic on-chain settlement.',
17
+ 'Spend controls and error handling: paid tools return `_oracle_proof` (ECDSA secp256k1) and `_meta` (upstream source and TTL). When HTTP 402 (`payment_required: true`) is returned without credentials, present the fee (`0.0050`–`0.0500` USDC) and free `preview` teaser instead of retrying blindly. Respect HTTP 429 (`PassDailyLimitExceeded`, `SandboxRateLimitExceeded`) and HTTP 403 (`PassEndpointNotAllowed`).',
18
+ ].join(' ');
19
+
13
20
  const server = new Server(
14
21
  {
15
22
  name: 'grid402-mcp-server',
16
- version: '1.6.0',
23
+ version: '1.9.0',
17
24
  },
18
25
  {
19
26
  capabilities: {
20
27
  tools: {},
21
28
  },
29
+ instructions: GRID402_MCP_INSTRUCTIONS,
22
30
  }
23
31
  );
24
32
 
@@ -70,6 +78,45 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
70
78
  case 'grid402_workdays':
71
79
  service = 'workdays';
72
80
  break;
81
+ case 'grid402_sanctions':
82
+ service = 'sanctions';
83
+ break;
84
+ case 'grid402_simples':
85
+ service = 'simples';
86
+ break;
87
+ case 'grid402_compliance':
88
+ service = 'compliance';
89
+ break;
90
+ case 'grid402_domain_audit':
91
+ service = 'domain-audit';
92
+ break;
93
+ case 'grid402_kyb_audit':
94
+ service = 'kyb-audit';
95
+ break;
96
+ case 'grid402_get_dossier_360':
97
+ service = 'dossier';
98
+ break;
99
+ case 'grid402_market_snapshot':
100
+ service = 'market-snapshot';
101
+ break;
102
+ case 'grid402_lei':
103
+ service = 'lei';
104
+ break;
105
+ case 'grid402_ofac':
106
+ service = 'ofac';
107
+ break;
108
+ case 'grid402_notarize':
109
+ service = 'notarize';
110
+ break;
111
+ case 'grid402_global_markets':
112
+ service = 'global-markets';
113
+ break;
114
+ case 'grid402_pass':
115
+ service = 'pass';
116
+ break;
117
+ case 'grid402_pass_balance':
118
+ service = 'pass-balance';
119
+ break;
73
120
  case 'grid402_verify':
74
121
  service = 'verify';
75
122
  break;
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "grid402-mcp",
3
- "version": "1.7.0",
4
- "description": "Official Model Context Protocol (MCP) Server for Grid402 - Public Open Data e Network Utilities Hub (Forex, Crypto, DNS, SSL, ASN, CEP, CNPJ, Indicators, Holidays, Workdays, Oracle Verifier) with Base x402 micropayments, Oracle Proof e Sandbox.",
3
+ "version": "1.9.0",
4
+ "description": "Official Model Context Protocol (MCP) Server for Grid402 - The Verifiable Data and HTTP x402 Payment Layer for Autonomous AI Agents (25 MCP Tools: KYB 360 AI Dossier, Financial Markets, Compliance, Global LEI, OFAC AML, Network Audits) across Base, Arbitrum, Polygon, Optimism, Ethereum and Solana.",
5
5
  "type": "module",
6
6
  "bin": {
7
7
  "grid402-mcp": "index.mjs"
package/tools.mjs CHANGED
@@ -7,12 +7,12 @@ import { settleX402Payment } from './x402_payer.mjs';
7
7
  export const DEFAULT_ENDPOINT = process.env.GRID402_ENDPOINT || process.env.GRID402_API_URL || 'https://grid402.online';
8
8
 
9
9
  /**
10
- * Definições formais das 11 ferramentas no padrão MCP
10
+ * Definições formais das 25 ferramentas no padrão MCP (23 micro-serviços + summary + pass_balance)
11
11
  */
12
12
  export const MCP_TOOLS_DEFINITIONS = [
13
13
  {
14
14
  name: 'grid402_summary',
15
- description: 'Consulta o resumo consolidado de saúde e disponibilidade dos 6 micro-serviços do Grid402 (gratuito, sem cobrança x402).',
15
+ description: 'Consulta o resumo consolidado de saúde e disponibilidade dos 23 micro-serviços do Grid402 (gratuito, sem cobrança x402).',
16
16
  inputSchema: {
17
17
  type: 'object',
18
18
  properties: {},
@@ -21,13 +21,13 @@ export const MCP_TOOLS_DEFINITIONS = [
21
21
  },
22
22
  {
23
23
  name: 'grid402_forex',
24
- description: 'Consulta cotações fiduciárias oficiais em tempo real de USD, EUR e GBP para BRL com variação percentual diária.',
24
+ description: 'Consulta cotações fiduciárias oficiais em tempo real de USD, EUR e GBP para BRL com variação percentual diária (0.0050 USDC / 1 crédito).',
25
25
  inputSchema: {
26
26
  type: 'object',
27
27
  properties: {
28
28
  payment_tx_hash: {
29
29
  type: 'string',
30
- description: 'Hash opcional de transação na Base Mainnet comprovando o pagamento de 0.0005 USDC caso não utilize liquidação automática.',
30
+ description: 'Hash opcional de transação na Base Mainnet comprovando o pagamento de 0.0050 USDC caso não utilize liquidação automática.',
31
31
  },
32
32
  },
33
33
  required: [],
@@ -35,13 +35,13 @@ export const MCP_TOOLS_DEFINITIONS = [
35
35
  },
36
36
  {
37
37
  name: 'grid402_crypto',
38
- description: 'Consulta preços de mercado spot em tempo real de BTC, ETH, SOL, USDC e BASE em USD e BRL.',
38
+ description: 'Consulta preços de mercado spot em tempo real de BTC, ETH, SOL, USDC e BASE em USD e BRL (0.0050 USDC / 1 crédito).',
39
39
  inputSchema: {
40
40
  type: 'object',
41
41
  properties: {
42
42
  payment_tx_hash: {
43
43
  type: 'string',
44
- description: 'Hash opcional de transação na Base Mainnet com 0.0005 USDC.',
44
+ description: 'Hash opcional de transação na Base Mainnet com 0.0050 USDC.',
45
45
  },
46
46
  },
47
47
  required: [],
@@ -49,7 +49,7 @@ export const MCP_TOOLS_DEFINITIONS = [
49
49
  },
50
50
  {
51
51
  name: 'grid402_dns',
52
- description: 'Executa resolução DNS autoritativa de registros A, AAAA, MX, TXT, NS e CNAME para qualquer domínio da internet.',
52
+ description: 'Executa resolução DNS autoritativa de registros A, AAAA, MX, TXT, NS e CNAME para qualquer domínio da internet (0.0050 USDC / 1 crédito).',
53
53
  inputSchema: {
54
54
  type: 'object',
55
55
  properties: {
@@ -59,7 +59,7 @@ export const MCP_TOOLS_DEFINITIONS = [
59
59
  },
60
60
  payment_tx_hash: {
61
61
  type: 'string',
62
- description: 'Hash opcional de transação na Base Mainnet com 0.0005 USDC.',
62
+ description: 'Hash opcional de transação na Base Mainnet com 0.0050 USDC.',
63
63
  },
64
64
  },
65
65
  required: ['domain'],
@@ -67,7 +67,7 @@ export const MCP_TOOLS_DEFINITIONS = [
67
67
  },
68
68
  {
69
69
  name: 'grid402_ssl',
70
- description: 'Inspeciona e valida o certificado TLS/SSL na porta 443 de um host (emissor, validade, SANs e contagem de dias restantes até expirar).',
70
+ description: 'Inspeciona e valida o certificado TLS/SSL na porta 443 de um host (emissor, validade, SANs e contagem de dias restantes até expirar) (0.0050 USDC / 1 crédito).',
71
71
  inputSchema: {
72
72
  type: 'object',
73
73
  properties: {
@@ -77,7 +77,7 @@ export const MCP_TOOLS_DEFINITIONS = [
77
77
  },
78
78
  payment_tx_hash: {
79
79
  type: 'string',
80
- description: 'Hash opcional de transação na Base Mainnet com 0.0005 USDC.',
80
+ description: 'Hash opcional de transação na Base Mainnet com 0.0050 USDC.',
81
81
  },
82
82
  },
83
83
  required: ['host'],
@@ -85,7 +85,7 @@ export const MCP_TOOLS_DEFINITIONS = [
85
85
  },
86
86
  {
87
87
  name: 'grid402_asn',
88
- description: 'Consulta inteligência de rede BGP, identificando número de ASN, bloco IP alocado, provedor/organização e país de origem.',
88
+ description: 'Consulta inteligência de rede BGP, identificando número de ASN, bloco IP alocado, provedor/organização e país de origem (0.0050 USDC / 1 crédito).',
89
89
  inputSchema: {
90
90
  type: 'object',
91
91
  properties: {
@@ -95,7 +95,75 @@ export const MCP_TOOLS_DEFINITIONS = [
95
95
  },
96
96
  payment_tx_hash: {
97
97
  type: 'string',
98
- description: 'Hash opcional de transação na Base Mainnet com 0.0005 USDC.',
98
+ description: 'Hash opcional de transação na Base Mainnet com 0.0050 USDC.',
99
+ },
100
+ },
101
+ required: [],
102
+ },
103
+ },
104
+ {
105
+ name: 'grid402_domain_audit',
106
+ description: 'Auditoria completa de infraestrutura de domínio (DNS + TLS/SSL + BGP/ASN) em chamada única consolidada (0.0150 USDC / 3 créditos).',
107
+ inputSchema: {
108
+ type: 'object',
109
+ properties: {
110
+ domain: {
111
+ type: 'string',
112
+ description: 'Domínio alvo para auditoria completa (ex: "base.org").',
113
+ },
114
+ payment_tx_hash: {
115
+ type: 'string',
116
+ description: 'Hash opcional de transação na Base Mainnet com 0.0150 USDC.',
117
+ },
118
+ },
119
+ required: ['domain'],
120
+ },
121
+ },
122
+ {
123
+ name: 'grid402_kyb_audit',
124
+ description: 'Auditoria corporativa global KYB em chamada única: Receita Federal CNPJ + Sanções OFAC/ONU + Identidade Global GLEIF LEI (0.0200 USDC / 4 créditos).',
125
+ inputSchema: {
126
+ type: 'object',
127
+ properties: {
128
+ cnpj: {
129
+ type: 'string',
130
+ description: 'CNPJ de 14 dígitos da empresa (ex: "00000000000191").',
131
+ },
132
+ payment_tx_hash: {
133
+ type: 'string',
134
+ description: 'Hash opcional de transação na Base Mainnet com 0.0200 USDC.',
135
+ },
136
+ },
137
+ required: ['cnpj'],
138
+ },
139
+ },
140
+ {
141
+ name: 'grid402_get_dossier_360',
142
+ description: 'Dossiê 360º KYB Premium com Veredito Sintetizado para IA (APPROVED, FLAGGED, REJECTED), score 0-100, Receita Federal (CNPJ), Simples/MEI e Sanções CGU (CEIS/CNEP) em chamada única (0.0500 USDC / 10 créditos).',
143
+ inputSchema: {
144
+ type: 'object',
145
+ properties: {
146
+ cnpj: {
147
+ type: 'string',
148
+ description: 'CNPJ de 14 dígitos da empresa brasileira (com ou sem pontuação, ex: "00000000000191").',
149
+ },
150
+ payment_tx_hash: {
151
+ type: 'string',
152
+ description: 'Hash opcional de transação na Base Mainnet com 0.0500 USDC ou token pass_g402_...',
153
+ },
154
+ },
155
+ required: ['cnpj'],
156
+ },
157
+ },
158
+ {
159
+ name: 'grid402_market_snapshot',
160
+ description: 'Panorama financeiro e macroeconômico consolidado em chamada única: Câmbio + Cripto + Selic/CDI/IPCA + Calendário ANBIMA (0.0150 USDC / 3 créditos).',
161
+ inputSchema: {
162
+ type: 'object',
163
+ properties: {
164
+ payment_tx_hash: {
165
+ type: 'string',
166
+ description: 'Hash opcional de transação na Base Mainnet com 0.0150 USDC.',
99
167
  },
100
168
  },
101
169
  required: [],
@@ -103,7 +171,7 @@ export const MCP_TOOLS_DEFINITIONS = [
103
171
  },
104
172
  {
105
173
  name: 'grid402_cep',
106
- description: 'Consulta a base pública de endereçamento postal brasileiro retornando logradouro, bairro, município, UF e código IBGE oficial.',
174
+ description: 'Consulta a base pública de endereçamento postal brasileiro retornando logradouro, bairro, município, UF e código IBGE oficial (0.0050 USDC / 1 crédito).',
107
175
  inputSchema: {
108
176
  type: 'object',
109
177
  properties: {
@@ -113,7 +181,7 @@ export const MCP_TOOLS_DEFINITIONS = [
113
181
  },
114
182
  payment_tx_hash: {
115
183
  type: 'string',
116
- description: 'Hash opcional de transação na Base Mainnet com 0.0005 USDC.',
184
+ description: 'Hash opcional de transação na Base Mainnet com 0.0050 USDC.',
117
185
  },
118
186
  },
119
187
  required: ['code'],
@@ -121,7 +189,7 @@ export const MCP_TOOLS_DEFINITIONS = [
121
189
  },
122
190
  {
123
191
  name: 'grid402_cnpj',
124
- description: 'Consulta dados cadastrais públicos de Pessoa Jurídica da Receita Federal (razão social, nome fantasia, situação cadastral, CNAE, endereço e capital social). Requer 0.0020 USDC.',
192
+ description: 'Consulta dados cadastrais públicos de Pessoa Jurídica da Receita Federal (razão social, nome fantasia, situação cadastral, CNAE, endereço e capital social). Requer 0.0200 USDC (4 créditos).',
125
193
  inputSchema: {
126
194
  type: 'object',
127
195
  properties: {
@@ -131,7 +199,7 @@ export const MCP_TOOLS_DEFINITIONS = [
131
199
  },
132
200
  payment_tx_hash: {
133
201
  type: 'string',
134
- description: 'Hash opcional de transação na Base Mainnet com 0.0020 USDC.',
202
+ description: 'Hash opcional de transação na Base Mainnet com 0.0200 USDC.',
135
203
  },
136
204
  },
137
205
  required: ['cnpj'],
@@ -139,13 +207,13 @@ export const MCP_TOOLS_DEFINITIONS = [
139
207
  },
140
208
  {
141
209
  name: 'grid402_indicators',
142
- description: 'Consulta taxas oficiais Selic meta e diária, CDI anual e diário, IPCA acumulado 12m e mensal do Banco Central e IBGE.',
210
+ description: 'Consulta taxas oficiais Selic meta e diária, CDI anual e diário, IPCA acumulado 12m e mensal do Banco Central e IBGE (0.0050 USDC / 1 crédito).',
143
211
  inputSchema: {
144
212
  type: 'object',
145
213
  properties: {
146
214
  payment_tx_hash: {
147
215
  type: 'string',
148
- description: 'Hash opcional de transação na Base Mainnet comprovando o pagamento de 0.0005 USDC caso não utilize liquidação automática.',
216
+ description: 'Hash opcional de transação na Base Mainnet comprovando o pagamento de 0.0050 USDC caso não utilize liquidação automática.',
149
217
  },
150
218
  },
151
219
  required: [],
@@ -153,7 +221,7 @@ export const MCP_TOOLS_DEFINITIONS = [
153
221
  },
154
222
  {
155
223
  name: 'grid402_holidays',
156
- description: 'Consulta o calendário oficial de feriados nacionais e dias sem expediente bancário (ANBIMA e Febraban) com cálculo de feriados móveis.',
224
+ description: 'Consulta o calendário oficial de feriados nacionais e dias sem expediente bancário (ANBIMA e Febraban) com cálculo de feriados móveis (0.0050 USDC / 1 crédito).',
157
225
  inputSchema: {
158
226
  type: 'object',
159
227
  properties: {
@@ -163,7 +231,7 @@ export const MCP_TOOLS_DEFINITIONS = [
163
231
  },
164
232
  payment_tx_hash: {
165
233
  type: 'string',
166
- description: 'Hash opcional de transação na Base Mainnet comprovando o pagamento de 0.0005 USDC caso não utilize liquidação automática.',
234
+ description: 'Hash opcional de transação na Base Mainnet comprovando o pagamento de 0.0050 USDC caso não utilize liquidação automática.',
167
235
  },
168
236
  },
169
237
  required: [],
@@ -171,7 +239,7 @@ export const MCP_TOOLS_DEFINITIONS = [
171
239
  },
172
240
  {
173
241
  name: 'grid402_workdays',
174
- description: 'Calcula dias úteis financeiros e projeção de vencimentos na convenção ANBIMA (D+0 exclusivo no início e inclusivo no fim) ou verifica se uma data é dia útil bancário.',
242
+ description: 'Calcula dias úteis financeiros e projeção de vencimentos na convenção ANBIMA (D+0 exclusivo no início e inclusivo no fim) ou verifica se uma data é dia útil bancário (0.0050 USDC / 1 crédito).',
175
243
  inputSchema: {
176
244
  type: 'object',
177
245
  properties: {
@@ -193,7 +261,161 @@ export const MCP_TOOLS_DEFINITIONS = [
193
261
  },
194
262
  payment_tx_hash: {
195
263
  type: 'string',
196
- description: 'Hash opcional de transacao na Base Mainnet comprovando o pagamento de 0.0005 USDC caso nao utilize liquidacao automatica.',
264
+ description: 'Hash opcional de transacao na Base Mainnet comprovando o pagamento de 0.0050 USDC caso nao utilize liquidacao automatica.',
265
+ },
266
+ },
267
+ required: [],
268
+ },
269
+ },
270
+ {
271
+ name: 'grid402_sanctions',
272
+ description: 'Consulta o Cadastro de Empresas Inidoneas e Suspensas (CEIS) e Cadastro Nacional de Empresas Punidas (CNEP) da CGU para um CNPJ (0.0100 USDC / 2 créditos).',
273
+ inputSchema: {
274
+ type: 'object',
275
+ properties: {
276
+ cnpj: {
277
+ type: 'string',
278
+ description: 'CNPJ da Pessoa Juridica com 14 digitos para checagem de sancoes.',
279
+ },
280
+ },
281
+ required: ['cnpj'],
282
+ },
283
+ },
284
+ {
285
+ name: 'grid402_simples',
286
+ description: 'Consulta o enquadramento de um CNPJ no regime tributario do Simples Nacional e se e Microempreendedor Individual (MEI) (0.0100 USDC / 2 créditos).',
287
+ inputSchema: {
288
+ type: 'object',
289
+ properties: {
290
+ cnpj: {
291
+ type: 'string',
292
+ description: 'CNPJ da Pessoa Juridica com 14 digitos para checagem tributaria.',
293
+ },
294
+ },
295
+ required: ['cnpj'],
296
+ },
297
+ },
298
+ {
299
+ name: 'grid402_compliance',
300
+ description: 'Calcula o Compliance Score 360 consolidado (0 a 100) e status de aprovacao de um CNPJ cruzando Receita Federal, CGU e historico (0.0300 USDC / 6 créditos).',
301
+ inputSchema: {
302
+ type: 'object',
303
+ properties: {
304
+ cnpj: {
305
+ type: 'string',
306
+ description: 'CNPJ da Pessoa Juridica com 14 digitos para score de integridade.',
307
+ },
308
+ },
309
+ required: ['cnpj'],
310
+ },
311
+ },
312
+ {
313
+ name: 'grid402_lei',
314
+ description: 'Consulta identidade corporativa internacional oficial (ISO 17442) em mais de 200 jurisdições via GLEIF (0.0200 USDC / 4 créditos).',
315
+ inputSchema: {
316
+ type: 'object',
317
+ properties: {
318
+ lei: {
319
+ type: 'string',
320
+ description: 'Código LEI de 20 caracteres (ex: "5493006MHB84DD0ZWV18") ou razão social.',
321
+ },
322
+ payment_tx_hash: {
323
+ type: 'string',
324
+ description: 'Hash opcional de transação na Base Mainnet com 0.0200 USDC.',
325
+ },
326
+ },
327
+ required: ['lei'],
328
+ },
329
+ },
330
+ {
331
+ name: 'grid402_ofac',
332
+ description: 'Triagem de sanções globais (OFAC SDN / ONU) e risco AML Web3 na Base Mainnet para carteiras 0x, códigos LEI ou entidades (0.0200 USDC / 4 créditos).',
333
+ inputSchema: {
334
+ type: 'object',
335
+ properties: {
336
+ target: {
337
+ type: 'string',
338
+ description: 'Carteira EVM 0x, código LEI ou razão social para triagem OFAC/AML.',
339
+ },
340
+ payment_tx_hash: {
341
+ type: 'string',
342
+ description: 'Hash opcional de transação na Base Mainnet com 0.0200 USDC.',
343
+ },
344
+ },
345
+ required: ['target'],
346
+ },
347
+ },
348
+ {
349
+ name: 'grid402_notarize',
350
+ description: 'Carimbo do tempo criptográfico M2M e prova de existência SHA-256 assinada com ECDSA secp256k1 (0.0050 USDC / 1 crédito).',
351
+ inputSchema: {
352
+ type: 'object',
353
+ properties: {
354
+ content: {
355
+ type: 'string',
356
+ description: 'Conteúdo textual ou hash SHA-256 hex de 64 caracteres para notarizar.',
357
+ },
358
+ payment_tx_hash: {
359
+ type: 'string',
360
+ description: 'Hash opcional de transação na Base Mainnet com 0.0050 USDC.',
361
+ },
362
+ },
363
+ required: ['content'],
364
+ },
365
+ },
366
+ {
367
+ name: 'grid402_global_markets',
368
+ description: 'Calendário de liquidação de bolsas globais (US NYSE/Fed, EU TARGET2, UK LSE, BR B3) e mais de 30 taxas de câmbio de referência do BCE (0.0050 USDC / 1 crédito).',
369
+ inputSchema: {
370
+ type: 'object',
371
+ properties: {
372
+ market: {
373
+ type: 'string',
374
+ description: 'Código do mercado: US, EU, UK ou BR (padrão: US).',
375
+ },
376
+ base: {
377
+ type: 'string',
378
+ description: 'Moeda base para taxas do BCE (padrão: USD).',
379
+ },
380
+ date: {
381
+ type: 'string',
382
+ description: 'Data opcional no formato AAAA-MM-DD.',
383
+ },
384
+ payment_tx_hash: {
385
+ type: 'string',
386
+ description: 'Hash opcional de transação na Base Mainnet com 0.0050 USDC.',
387
+ },
388
+ },
389
+ required: [],
390
+ },
391
+ },
392
+ {
393
+ name: 'grid402_pass',
394
+ description: 'Emite um Session Pass pré-pago x402 (Starter 2 USDC = 400 créditos, Pro 5 USDC = 1.000 créditos, Fleet 20 USDC = 6.000 créditos; 1 crédito = 0.0050 USDC) ou consulta status via ?status=pass_g402_...',
395
+ inputSchema: {
396
+ type: 'object',
397
+ properties: {
398
+ status: {
399
+ type: 'string',
400
+ description: 'Token pass_g402_... opcional para consulta gratuita de saldo.',
401
+ },
402
+ payment_tx_hash: {
403
+ type: 'string',
404
+ description: 'Hash opcional de transação na Base Mainnet para emissão de novo passe.',
405
+ },
406
+ },
407
+ required: [],
408
+ },
409
+ },
410
+ {
411
+ name: 'grid402_pass_balance',
412
+ description: 'Consulta gratuita em tempo real do saldo de créditos, validade e Spend Controls (daily_credit_limit, credits_used_today, allowed_endpoints) de um Session Pass.',
413
+ inputSchema: {
414
+ type: 'object',
415
+ properties: {
416
+ token: {
417
+ type: 'string',
418
+ description: 'Token pass_g402_... a consultar (ou utiliza GRID402_SESSION_PASS do ambiente).',
197
419
  },
198
420
  },
199
421
  required: [],
@@ -248,6 +470,25 @@ export async function executeGrid402Request(service, params = {}, options = {})
248
470
  path = '/api/v1/asn';
249
471
  if (params.ip) queryParams.set('ip', params.ip);
250
472
  break;
473
+ case 'domain-audit':
474
+ case 'domain_audit':
475
+ path = '/api/v1/domain-audit';
476
+ if (params.domain) queryParams.set('domain', params.domain);
477
+ break;
478
+ case 'kyb-audit':
479
+ case 'kyb_audit':
480
+ path = '/api/v1/kyb-audit';
481
+ if (params.cnpj) queryParams.set('cnpj', params.cnpj);
482
+ break;
483
+ case 'dossier':
484
+ case 'get_dossier_360':
485
+ path = '/api/v1/dossier';
486
+ if (params.cnpj) queryParams.set('cnpj', params.cnpj);
487
+ break;
488
+ case 'market-snapshot':
489
+ case 'market_snapshot':
490
+ path = '/api/v1/market-snapshot';
491
+ break;
251
492
  case 'cep':
252
493
  path = '/api/v1/cep';
253
494
  if (params.code) queryParams.set('code', params.code);
@@ -267,9 +508,53 @@ export async function executeGrid402Request(service, params = {}, options = {})
267
508
  path = '/api/v1/workdays';
268
509
  if (params.start_date || params.startDate) queryParams.set('start_date', params.start_date || params.startDate);
269
510
  if (params.end_date || params.endDate) queryParams.set('end_date', params.end_date || params.endDate);
270
- if (params.days !== undefined && params.days !== null) queryParams.set('days', params.days);
511
+ if (params.days !== undefined) {
512
+ if (params.days !== null) {
513
+ queryParams.set('days', params.days);
514
+ }
515
+ }
271
516
  if (params.date) queryParams.set('date', params.date);
272
517
  break;
518
+ case 'sanctions':
519
+ path = '/api/v1/sanctions';
520
+ if (params.cnpj) queryParams.set('cnpj', params.cnpj);
521
+ break;
522
+ case 'simples':
523
+ path = '/api/v1/simples';
524
+ if (params.cnpj) queryParams.set('cnpj', params.cnpj);
525
+ break;
526
+ case 'compliance':
527
+ path = '/api/v1/compliance';
528
+ if (params.cnpj) queryParams.set('cnpj', params.cnpj);
529
+ break;
530
+ case 'lei':
531
+ path = '/api/v1/lei';
532
+ if (params.lei) queryParams.set('lei', params.lei);
533
+ break;
534
+ case 'ofac':
535
+ path = '/api/v1/ofac';
536
+ if (params.target) queryParams.set('target', params.target);
537
+ break;
538
+ case 'notarize':
539
+ path = '/api/v1/notarize';
540
+ if (params.content) queryParams.set('content', params.content);
541
+ break;
542
+ case 'global-markets':
543
+ case 'global_markets':
544
+ path = '/api/v1/global-markets';
545
+ if (params.market) queryParams.set('market', params.market);
546
+ if (params.base) queryParams.set('base', params.base);
547
+ if (params.date) queryParams.set('date', params.date);
548
+ break;
549
+ case 'pass':
550
+ path = '/api/v1/pass';
551
+ if (params.status) queryParams.set('status', params.status);
552
+ break;
553
+ case 'pass-balance':
554
+ case 'pass_balance':
555
+ path = '/api/v1/pass/balance';
556
+ if (params.token) queryParams.set('token', params.token);
557
+ break;
273
558
  case 'verify':
274
559
  path = '/api/v1/verify';
275
560
  break;
@@ -285,7 +570,7 @@ export async function executeGrid402Request(service, params = {}, options = {})
285
570
  headers: {
286
571
  'Content-Type': 'application/json',
287
572
  'Accept': 'application/json',
288
- 'User-Agent': 'Grid402-MCP-Server/1.6',
573
+ 'User-Agent': 'Grid402-MCP-Server/1.8',
289
574
  },
290
575
  body: postPayload,
291
576
  });
@@ -297,11 +582,17 @@ export async function executeGrid402Request(service, params = {}, options = {})
297
582
 
298
583
  const headers = {
299
584
  'Accept': 'application/json',
300
- 'User-Agent': 'Grid402-MCP-Server/1.6',
585
+ 'User-Agent': 'Grid402-MCP-Server/1.8',
301
586
  };
302
587
 
588
+ if (params.idempotency_key) {
589
+ headers['Idempotency-Key'] = String(params.idempotency_key);
590
+ }
591
+
303
592
  if (params.payment_tx_hash) {
304
593
  headers['X-Payment'] = params.payment_tx_hash;
594
+ } else if (process.env.GRID402_SESSION_PASS) {
595
+ headers['X-Payment'] = process.env.GRID402_SESSION_PASS.trim();
305
596
  } else if (process.env.GRID402_SANDBOX === 'true' || process.env.GRID402_SANDBOX === '1') {
306
597
  headers['X-Payment'] = 'demo';
307
598
  }
@@ -348,12 +639,12 @@ export async function executeGrid402Request(service, params = {}, options = {})
348
639
  }
349
640
  }
350
641
 
351
- // Se não há chave privada configurada, retorna o desafio de pagamento estruturado
642
+ // Se não há chave privada ou session pass configurados, retorna o desafio de pagamento estruturado
352
643
  return {
353
644
  payment_required: true,
354
- message: 'Esta consulta requer micropagamento de 0.0005 USDC na rede Base via protocolo x402.',
645
+ message: 'Esta consulta requer micropagamento em USDC na rede Base via protocolo x402.',
355
646
  challenge,
356
- instructions: 'Para liquidação automática, defina a variável de ambiente GRID402_PRIVATE_KEY no seu arquivo de configuração MCP.',
647
+ instructions: 'Opções de acesso: (1) Teste grátis definindo GRID402_SANDBOX=true; (2) Use um passe pré-pago sem expor chave privada definindo GRID402_SESSION_PASS=pass_g402_...; (3) Para auto-liquidação on-chain x402, defina GRID402_PRIVATE_KEY.',
357
648
  };
358
649
  }
359
650
 
@@ -364,4 +655,3 @@ export async function executeGrid402Request(service, params = {}, options = {})
364
655
  throw new Error(`Erro na API Grid402 (HTTP ${response.status}): ${errText}`);
365
656
  }
366
657
  }
367
-
package/x402_payer.mjs CHANGED
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * Grid402 MCP Server - Módulo de Liquidação x402 On-Chain (Base Mainnet)
3
3
  *
4
- * Permite pagamentos automáticos de US$ 0.0005 USDC via transferência ERC-20
4
+ * Permite pagamentos automáticos de US$ 0.0050 USDC via transferência ERC-20
5
5
  * quando uma chave privada é fornecida no ambiente do agente.
6
6
  */
7
7
 
@@ -14,8 +14,8 @@ export const BASE_RPC_URLS = [
14
14
  ];
15
15
 
16
16
  export const USDC_CONTRACT_BASE = '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'.toLowerCase();
17
- export const GRID402_RECIPIENT_WALLET = '0xa31c31069c43ac1c0075a93c325b0dcd7744356c'.toLowerCase();
18
- export const REQUIRED_RAW_UNITS = 500n; // 0.000500 USDC (6 casas decimais)
17
+ export const GRID402_RECIPIENT_WALLET = '0xa592625adbceb8e025ac383f1a3fd8ebb6a63f90'.toLowerCase();
18
+ export const REQUIRED_RAW_UNITS = 5000n; // 0.0050 USDC (6 casas decimais)
19
19
 
20
20
  const ERC20_ABI = [
21
21
  'function transfer(address to, uint256 amount) returns (bool)',
@@ -40,7 +40,7 @@ export async function getBaseProvider(preferredRpc = null) {
40
40
  }
41
41
 
42
42
  /**
43
- * Executa a transferência de 0.0005 USDC na Base para liquidar o desafio x402
43
+ * Executa a transferência de 0.0050 USDC na Base para liquidar o desafio x402
44
44
  *
45
45
  * @param {object} challenge Desafio retornado pelo Grid402 (HTTP 402)
46
46
  * @param {string} privateKey Chave privada hexadecimal da carteira pagadora
@@ -66,7 +66,7 @@ export async function settleX402Payment(challenge, privateKey, preferredRpc = nu
66
66
  try {
67
67
  const balance = await usdc.balanceOf(wallet.address);
68
68
  if (balance < rawUnits) {
69
- throw new Error(`Saldo insuficiente de USDC na carteira ${wallet.address}. Requerido: 0.0005 USDC, Atual: ${ethers.formatUnits(balance, 6)} USDC.`);
69
+ throw new Error(`Saldo insuficiente de USDC na carteira ${wallet.address}. Requerido: 0.0050 USDC, Atual: ${ethers.formatUnits(balance, 6)} USDC.`);
70
70
  }
71
71
  } catch (err) {
72
72
  if (err.message.includes('Saldo insuficiente')) {
@@ -84,7 +84,7 @@ export async function settleX402Payment(challenge, privateKey, preferredRpc = nu
84
84
  blockNumber: receipt.blockNumber,
85
85
  from: wallet.address,
86
86
  to: recipient,
87
- amountUsdc: '0.0005',
87
+ amountUsdc: '0.0050',
88
88
  };
89
89
  }
90
90