grid402-mcp 1.6.0 → 1.8.2

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
@@ -11,16 +11,16 @@ Compatível nativamente com **Claude Desktop**, **Cursor**, **Smithery.ai**, **C
11
11
  | Ferramenta | Descrição | Modalidade | Custo |
12
12
  |---|---|---|---|
13
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 |
14
+ | `grid402_forex` | Cotações em tempo real de USD, EUR e GBP para BRL | On-Demand | 0.0050 USDC |
15
+ | `grid402_crypto` | Preços spot de BTC, ETH, SOL, USDC e BASE | On-Demand | 0.0050 USDC |
16
+ | `grid402_dns` | Resolução autoritativa de DNS (A, AAAA, MX, TXT, NS, CNAME) | On-Demand | 0.0050 USDC |
17
+ | `grid402_ssl` | Inspeção de validade, emissor e dias restantes de certificados TLS/SSL | On-Demand | 0.0050 USDC |
18
+ | `grid402_asn` | Inteligência BGP, número ASN, organização e país de bloco IP | On-Demand | 0.0050 USDC |
19
+ | `grid402_cep` | Consulta de endereço postal brasileiro e código IBGE oficial | On-Demand | 0.0050 USDC |
20
+ | `grid402_cnpj` | Consulta cadastral de CNPJ da Receita Federal com status e CNAE | On-Demand | 0.0200 USDC |
21
+ | `grid402_indicators` | Indicadores macroeconômicos oficiais (Selic meta e diária, CDI anual e IPCA) | On-Demand | 0.0050 USDC |
22
+ | `grid402_holidays` | Calendário oficial de feriados nacionais e bancários ANBIMA por ano | On-Demand | 0.0050 USDC |
23
+ | `grid402_workdays` | Calculadora de dias úteis financeiros e projeção de vencimentos ANBIMA | On-Demand | 0.0050 USDC |
24
24
  | `grid402_verify` | Validação matemática de prova criptográfica de oráculo (_oracle_proof) secp256k1 | Direto | Gratuito |
25
25
 
26
26
  ---
@@ -56,16 +56,19 @@ Adicione ao seu arquivo de configuração (`claude_desktop_config.json`):
56
56
  "command": "npx",
57
57
  "args": ["-y", "grid402-mcp"],
58
58
  "env": {
59
- "GRID402_ENDPOINT": "https://orangered-jackal-900744.hostingersite.com",
59
+ "GRID402_ENDPOINT": "https://grid402.online",
60
60
  "GRID402_SANDBOX": "false",
61
- "GRID402_PRIVATE_KEY": "0xsua_chave_privada_base_aqui"
61
+ "GRID402_SESSION_PASS": "pass_g402_seu_passe_aqui_opcional",
62
+ "GRID402_PRIVATE_KEY": "0xsua_chave_privada_base_aqui_opcional"
62
63
  }
63
64
  }
64
65
  }
65
66
  }
66
67
  ```
67
68
 
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).
69
+ > 💡 **Modo Sandbox Gratuito:** Você pode definir `"GRID402_SANDBOX": "true"` para testar todas as ferramentas sem gastar USDC nem configurar chave privada (limite de 3 consultas por hora por IP).
70
+ >
71
+ > 💡 **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
72
  >
70
73
  > 💡 **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
74
 
@@ -104,7 +107,7 @@ O provedor gerencia automaticamente o ciclo de vida HTTP 402, transferindo os mi
104
107
 
105
108
  ## 🛡️ Prova Criptografica de Oraculo (Proof of Data)
106
109
 
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.
110
+ 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
111
 
109
112
  ---
110
113
 
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 24 tools for real-time open data and M2M network utilities with Base x402 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 on Base Mainnet (Chain ID 8453) settled via HTTP x402 (USDC).',
15
+ 'Tool selection: use free tools first (`grid402_summary` for 22-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_market_snapshot`) over multiple separate calls to reduce cost and latency.',
16
+ 'Authentication & 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 & 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.0300` 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.8.2',
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,42 @@ 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_market_snapshot':
97
+ service = 'market-snapshot';
98
+ break;
99
+ case 'grid402_lei':
100
+ service = 'lei';
101
+ break;
102
+ case 'grid402_ofac':
103
+ service = 'ofac';
104
+ break;
105
+ case 'grid402_notarize':
106
+ service = 'notarize';
107
+ break;
108
+ case 'grid402_global_markets':
109
+ service = 'global-markets';
110
+ break;
111
+ case 'grid402_pass':
112
+ service = 'pass';
113
+ break;
114
+ case 'grid402_pass_balance':
115
+ service = 'pass-balance';
116
+ break;
73
117
  case 'grid402_verify':
74
118
  service = 'verify';
75
119
  break;
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "grid402-mcp",
3
- "version": "1.6.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.8.2",
4
+ "description": "Official Model Context Protocol (MCP) Server for Grid402 - The Verifiable Data and x402 Payment Layer for Autonomous AI Agents (24 MCP Tools: Financial Markets, Compliance, Global LEI, OFAC AML, Network Audits) on Base.",
5
5
  "type": "module",
6
6
  "bin": {
7
7
  "grid402-mcp": "index.mjs"
@@ -44,9 +44,9 @@
44
44
  "proof-of-data",
45
45
  "sandbox"
46
46
  ],
47
- "author": "Grid402 Team <contato@grid402.com.br>",
47
+ "author": "Grid402 Team <contato@grid402.online>",
48
48
  "license": "MIT",
49
- "homepage": "https://www.grid402.com.br",
49
+ "homepage": "https://grid402.online",
50
50
  "repository": {
51
51
  "type": "git",
52
52
  "url": "git+https://github.com/oliveiratc/Grid402.git"
package/tools.mjs CHANGED
@@ -4,15 +4,15 @@
4
4
 
5
5
  import { settleX402Payment } from './x402_payer.mjs';
6
6
 
7
- export const DEFAULT_ENDPOINT = process.env.GRID402_ENDPOINT || process.env.GRID402_API_URL || 'https://orangered-jackal-900744.hostingersite.com';
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 24 ferramentas no padrão MCP (22 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 22 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,57 @@ 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: 'Dossiê corporativo KYB unificado em chamada única: Receita Federal CNPJ + Simples/MEI + Sanções CEIS/CNEP + Compliance Score 360 (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_market_snapshot',
142
+ 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).',
143
+ inputSchema: {
144
+ type: 'object',
145
+ properties: {
146
+ payment_tx_hash: {
147
+ type: 'string',
148
+ description: 'Hash opcional de transação na Base Mainnet com 0.0150 USDC.',
99
149
  },
100
150
  },
101
151
  required: [],
@@ -103,7 +153,7 @@ export const MCP_TOOLS_DEFINITIONS = [
103
153
  },
104
154
  {
105
155
  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.',
156
+ 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
157
  inputSchema: {
108
158
  type: 'object',
109
159
  properties: {
@@ -113,7 +163,7 @@ export const MCP_TOOLS_DEFINITIONS = [
113
163
  },
114
164
  payment_tx_hash: {
115
165
  type: 'string',
116
- description: 'Hash opcional de transação na Base Mainnet com 0.0005 USDC.',
166
+ description: 'Hash opcional de transação na Base Mainnet com 0.0050 USDC.',
117
167
  },
118
168
  },
119
169
  required: ['code'],
@@ -121,7 +171,7 @@ export const MCP_TOOLS_DEFINITIONS = [
121
171
  },
122
172
  {
123
173
  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.',
174
+ 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
175
  inputSchema: {
126
176
  type: 'object',
127
177
  properties: {
@@ -131,7 +181,7 @@ export const MCP_TOOLS_DEFINITIONS = [
131
181
  },
132
182
  payment_tx_hash: {
133
183
  type: 'string',
134
- description: 'Hash opcional de transação na Base Mainnet com 0.0020 USDC.',
184
+ description: 'Hash opcional de transação na Base Mainnet com 0.0200 USDC.',
135
185
  },
136
186
  },
137
187
  required: ['cnpj'],
@@ -139,13 +189,13 @@ export const MCP_TOOLS_DEFINITIONS = [
139
189
  },
140
190
  {
141
191
  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.',
192
+ 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
193
  inputSchema: {
144
194
  type: 'object',
145
195
  properties: {
146
196
  payment_tx_hash: {
147
197
  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.',
198
+ 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
199
  },
150
200
  },
151
201
  required: [],
@@ -153,7 +203,7 @@ export const MCP_TOOLS_DEFINITIONS = [
153
203
  },
154
204
  {
155
205
  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.',
206
+ 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
207
  inputSchema: {
158
208
  type: 'object',
159
209
  properties: {
@@ -163,7 +213,7 @@ export const MCP_TOOLS_DEFINITIONS = [
163
213
  },
164
214
  payment_tx_hash: {
165
215
  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.',
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.',
167
217
  },
168
218
  },
169
219
  required: [],
@@ -171,7 +221,7 @@ export const MCP_TOOLS_DEFINITIONS = [
171
221
  },
172
222
  {
173
223
  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.',
224
+ 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
225
  inputSchema: {
176
226
  type: 'object',
177
227
  properties: {
@@ -193,7 +243,161 @@ export const MCP_TOOLS_DEFINITIONS = [
193
243
  },
194
244
  payment_tx_hash: {
195
245
  type: 'string',
196
- description: 'Hash opcional de transacao na Base Mainnet comprovando o pagamento de 0.0005 USDC caso nao utilize liquidacao automatica.',
246
+ description: 'Hash opcional de transacao na Base Mainnet comprovando o pagamento de 0.0050 USDC caso nao utilize liquidacao automatica.',
247
+ },
248
+ },
249
+ required: [],
250
+ },
251
+ },
252
+ {
253
+ name: 'grid402_sanctions',
254
+ 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).',
255
+ inputSchema: {
256
+ type: 'object',
257
+ properties: {
258
+ cnpj: {
259
+ type: 'string',
260
+ description: 'CNPJ da Pessoa Juridica com 14 digitos para checagem de sancoes.',
261
+ },
262
+ },
263
+ required: ['cnpj'],
264
+ },
265
+ },
266
+ {
267
+ name: 'grid402_simples',
268
+ 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).',
269
+ inputSchema: {
270
+ type: 'object',
271
+ properties: {
272
+ cnpj: {
273
+ type: 'string',
274
+ description: 'CNPJ da Pessoa Juridica com 14 digitos para checagem tributaria.',
275
+ },
276
+ },
277
+ required: ['cnpj'],
278
+ },
279
+ },
280
+ {
281
+ name: 'grid402_compliance',
282
+ 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).',
283
+ inputSchema: {
284
+ type: 'object',
285
+ properties: {
286
+ cnpj: {
287
+ type: 'string',
288
+ description: 'CNPJ da Pessoa Juridica com 14 digitos para score de integridade.',
289
+ },
290
+ },
291
+ required: ['cnpj'],
292
+ },
293
+ },
294
+ {
295
+ name: 'grid402_lei',
296
+ description: 'Consulta identidade corporativa internacional oficial (ISO 17442) em mais de 200 jurisdições via GLEIF (0.0200 USDC / 4 créditos).',
297
+ inputSchema: {
298
+ type: 'object',
299
+ properties: {
300
+ lei: {
301
+ type: 'string',
302
+ description: 'Código LEI de 20 caracteres (ex: "5493006MHB84DD0ZWV18") ou razão social.',
303
+ },
304
+ payment_tx_hash: {
305
+ type: 'string',
306
+ description: 'Hash opcional de transação na Base Mainnet com 0.0200 USDC.',
307
+ },
308
+ },
309
+ required: ['lei'],
310
+ },
311
+ },
312
+ {
313
+ name: 'grid402_ofac',
314
+ 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).',
315
+ inputSchema: {
316
+ type: 'object',
317
+ properties: {
318
+ target: {
319
+ type: 'string',
320
+ description: 'Carteira EVM 0x, código LEI ou razão social para triagem OFAC/AML.',
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: ['target'],
328
+ },
329
+ },
330
+ {
331
+ name: 'grid402_notarize',
332
+ description: 'Carimbo do tempo criptográfico M2M e prova de existência SHA-256 assinada com ECDSA secp256k1 (0.0050 USDC / 1 crédito).',
333
+ inputSchema: {
334
+ type: 'object',
335
+ properties: {
336
+ content: {
337
+ type: 'string',
338
+ description: 'Conteúdo textual ou hash SHA-256 hex de 64 caracteres para notarizar.',
339
+ },
340
+ payment_tx_hash: {
341
+ type: 'string',
342
+ description: 'Hash opcional de transação na Base Mainnet com 0.0050 USDC.',
343
+ },
344
+ },
345
+ required: ['content'],
346
+ },
347
+ },
348
+ {
349
+ name: 'grid402_global_markets',
350
+ 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).',
351
+ inputSchema: {
352
+ type: 'object',
353
+ properties: {
354
+ market: {
355
+ type: 'string',
356
+ description: 'Código do mercado: US, EU, UK ou BR (padrão: US).',
357
+ },
358
+ base: {
359
+ type: 'string',
360
+ description: 'Moeda base para taxas do BCE (padrão: USD).',
361
+ },
362
+ date: {
363
+ type: 'string',
364
+ description: 'Data opcional no formato AAAA-MM-DD.',
365
+ },
366
+ payment_tx_hash: {
367
+ type: 'string',
368
+ description: 'Hash opcional de transação na Base Mainnet com 0.0050 USDC.',
369
+ },
370
+ },
371
+ required: [],
372
+ },
373
+ },
374
+ {
375
+ name: 'grid402_pass',
376
+ 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_...',
377
+ inputSchema: {
378
+ type: 'object',
379
+ properties: {
380
+ status: {
381
+ type: 'string',
382
+ description: 'Token pass_g402_... opcional para consulta gratuita de saldo.',
383
+ },
384
+ payment_tx_hash: {
385
+ type: 'string',
386
+ description: 'Hash opcional de transação na Base Mainnet para emissão de novo passe.',
387
+ },
388
+ },
389
+ required: [],
390
+ },
391
+ },
392
+ {
393
+ name: 'grid402_pass_balance',
394
+ 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.',
395
+ inputSchema: {
396
+ type: 'object',
397
+ properties: {
398
+ token: {
399
+ type: 'string',
400
+ description: 'Token pass_g402_... a consultar (ou utiliza GRID402_SESSION_PASS do ambiente).',
197
401
  },
198
402
  },
199
403
  required: [],
@@ -248,6 +452,20 @@ export async function executeGrid402Request(service, params = {}, options = {})
248
452
  path = '/api/v1/asn';
249
453
  if (params.ip) queryParams.set('ip', params.ip);
250
454
  break;
455
+ case 'domain-audit':
456
+ case 'domain_audit':
457
+ path = '/api/v1/domain-audit';
458
+ if (params.domain) queryParams.set('domain', params.domain);
459
+ break;
460
+ case 'kyb-audit':
461
+ case 'kyb_audit':
462
+ path = '/api/v1/kyb-audit';
463
+ if (params.cnpj) queryParams.set('cnpj', params.cnpj);
464
+ break;
465
+ case 'market-snapshot':
466
+ case 'market_snapshot':
467
+ path = '/api/v1/market-snapshot';
468
+ break;
251
469
  case 'cep':
252
470
  path = '/api/v1/cep';
253
471
  if (params.code) queryParams.set('code', params.code);
@@ -267,9 +485,53 @@ export async function executeGrid402Request(service, params = {}, options = {})
267
485
  path = '/api/v1/workdays';
268
486
  if (params.start_date || params.startDate) queryParams.set('start_date', params.start_date || params.startDate);
269
487
  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);
488
+ if (params.days !== undefined) {
489
+ if (params.days !== null) {
490
+ queryParams.set('days', params.days);
491
+ }
492
+ }
271
493
  if (params.date) queryParams.set('date', params.date);
272
494
  break;
495
+ case 'sanctions':
496
+ path = '/api/v1/sanctions';
497
+ if (params.cnpj) queryParams.set('cnpj', params.cnpj);
498
+ break;
499
+ case 'simples':
500
+ path = '/api/v1/simples';
501
+ if (params.cnpj) queryParams.set('cnpj', params.cnpj);
502
+ break;
503
+ case 'compliance':
504
+ path = '/api/v1/compliance';
505
+ if (params.cnpj) queryParams.set('cnpj', params.cnpj);
506
+ break;
507
+ case 'lei':
508
+ path = '/api/v1/lei';
509
+ if (params.lei) queryParams.set('lei', params.lei);
510
+ break;
511
+ case 'ofac':
512
+ path = '/api/v1/ofac';
513
+ if (params.target) queryParams.set('target', params.target);
514
+ break;
515
+ case 'notarize':
516
+ path = '/api/v1/notarize';
517
+ if (params.content) queryParams.set('content', params.content);
518
+ break;
519
+ case 'global-markets':
520
+ case 'global_markets':
521
+ path = '/api/v1/global-markets';
522
+ if (params.market) queryParams.set('market', params.market);
523
+ if (params.base) queryParams.set('base', params.base);
524
+ if (params.date) queryParams.set('date', params.date);
525
+ break;
526
+ case 'pass':
527
+ path = '/api/v1/pass';
528
+ if (params.status) queryParams.set('status', params.status);
529
+ break;
530
+ case 'pass-balance':
531
+ case 'pass_balance':
532
+ path = '/api/v1/pass/balance';
533
+ if (params.token) queryParams.set('token', params.token);
534
+ break;
273
535
  case 'verify':
274
536
  path = '/api/v1/verify';
275
537
  break;
@@ -285,7 +547,7 @@ export async function executeGrid402Request(service, params = {}, options = {})
285
547
  headers: {
286
548
  'Content-Type': 'application/json',
287
549
  'Accept': 'application/json',
288
- 'User-Agent': 'Grid402-MCP-Server/1.6',
550
+ 'User-Agent': 'Grid402-MCP-Server/1.8',
289
551
  },
290
552
  body: postPayload,
291
553
  });
@@ -297,11 +559,17 @@ export async function executeGrid402Request(service, params = {}, options = {})
297
559
 
298
560
  const headers = {
299
561
  'Accept': 'application/json',
300
- 'User-Agent': 'Grid402-MCP-Server/1.6',
562
+ 'User-Agent': 'Grid402-MCP-Server/1.8',
301
563
  };
302
564
 
565
+ if (params.idempotency_key) {
566
+ headers['Idempotency-Key'] = String(params.idempotency_key);
567
+ }
568
+
303
569
  if (params.payment_tx_hash) {
304
570
  headers['X-Payment'] = params.payment_tx_hash;
571
+ } else if (process.env.GRID402_SESSION_PASS) {
572
+ headers['X-Payment'] = process.env.GRID402_SESSION_PASS.trim();
305
573
  } else if (process.env.GRID402_SANDBOX === 'true' || process.env.GRID402_SANDBOX === '1') {
306
574
  headers['X-Payment'] = 'demo';
307
575
  }
@@ -348,12 +616,12 @@ export async function executeGrid402Request(service, params = {}, options = {})
348
616
  }
349
617
  }
350
618
 
351
- // Se não há chave privada configurada, retorna o desafio de pagamento estruturado
619
+ // Se não há chave privada ou session pass configurados, retorna o desafio de pagamento estruturado
352
620
  return {
353
621
  payment_required: true,
354
- message: 'Esta consulta requer micropagamento de 0.0005 USDC na rede Base via protocolo x402.',
622
+ message: 'Esta consulta requer micropagamento em USDC na rede Base via protocolo x402.',
355
623
  challenge,
356
- instructions: 'Para liquidação automática, defina a variável de ambiente GRID402_PRIVATE_KEY no seu arquivo de configuração MCP.',
624
+ 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
625
  };
358
626
  }
359
627
 
@@ -364,4 +632,3 @@ export async function executeGrid402Request(service, params = {}, options = {})
364
632
  throw new Error(`Erro na API Grid402 (HTTP ${response.status}): ${errText}`);
365
633
  }
366
634
  }
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