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 +33 -17
- package/index.mjs +49 -2
- package/package.json +2 -2
- package/tools.mjs +319 -29
- package/x402_payer.mjs +6 -6
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
|
|
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.
|
|
15
|
-
| `grid402_crypto` | Preços spot de BTC, ETH, SOL, USDC e BASE | On-Demand | 0.
|
|
16
|
-
| `grid402_dns` | Resolução autoritativa de DNS (A, AAAA, MX, TXT, NS, CNAME) | On-Demand | 0.
|
|
17
|
-
| `grid402_ssl` | Inspeção de validade, emissor e dias restantes de certificados TLS/SSL | On-Demand | 0.
|
|
18
|
-
| `grid402_asn` | Inteligência BGP, número ASN, organização e país de bloco IP | On-Demand | 0.
|
|
19
|
-
| `
|
|
20
|
-
| `
|
|
21
|
-
| `
|
|
22
|
-
| `
|
|
23
|
-
| `
|
|
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
|
-
"
|
|
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
|
|
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 (`
|
|
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
|
|
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.
|
|
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.
|
|
4
|
-
"description": "Official Model Context Protocol (MCP) Server for Grid402 -
|
|
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
|
|
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
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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
|
|
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.
|
|
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.
|
|
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
|
|
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
|
|
645
|
+
message: 'Esta consulta requer micropagamento em USDC na rede Base via protocolo x402.',
|
|
355
646
|
challenge,
|
|
356
|
-
instructions: '
|
|
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.
|
|
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 = '
|
|
18
|
-
export const REQUIRED_RAW_UNITS =
|
|
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.
|
|
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.
|
|
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.
|
|
87
|
+
amountUsdc: '0.0050',
|
|
88
88
|
};
|
|
89
89
|
}
|
|
90
90
|
|