grid402-mcp 1.8.2 → 2.0.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 +28 -15
- package/index.mjs +15 -6
- package/package.json +2 -2
- package/tools.mjs +78 -5
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.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
|
-
| `
|
|
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
|
---
|
|
@@ -66,7 +79,7 @@ Adicione ao seu arquivo de configuração (`claude_desktop_config.json`):
|
|
|
66
79
|
}
|
|
67
80
|
```
|
|
68
81
|
|
|
69
|
-
> 💡 **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).
|
|
70
83
|
>
|
|
71
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`.
|
|
72
85
|
>
|
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 27 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';
|
|
@@ -11,16 +11,16 @@ import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprot
|
|
|
11
11
|
import { MCP_TOOLS_DEFINITIONS, executeGrid402Request, DEFAULT_ENDPOINT } from './tools.mjs';
|
|
12
12
|
|
|
13
13
|
export const GRID402_MCP_INSTRUCTIONS = [
|
|
14
|
-
'Grid402 is a verifiable public-data and network utility M2M oracle on Base
|
|
15
|
-
'Tool selection: use free tools first (`grid402_summary` for
|
|
16
|
-
'Authentication
|
|
17
|
-
'Spend controls
|
|
14
|
+
'Grid402 is a verifiable public-data and network utility M2M oracle settled via HTTP x402 (gasless PayAI exact on Base, Polygon, Arbitrum, and Solana; plus Optimism and Ethereum Session Pass top-ups).',
|
|
15
|
+
'Tool selection: use free tools first (`grid402_summary` for 25-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, and use `grid402_extract` (URL-to-Markdown) or `grid402_email_verify` (Zero-PII MX/SPF/DMARC) for high-volume web and lead workflows.',
|
|
16
|
+
'Authentication and Payment modes: (1) Set `GRID402_SANDBOX=true` for free sandbox testing via `X-Payment: demo` (3 queries/day 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 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
18
|
].join(' ');
|
|
19
19
|
|
|
20
20
|
const server = new Server(
|
|
21
21
|
{
|
|
22
22
|
name: 'grid402-mcp-server',
|
|
23
|
-
version: '
|
|
23
|
+
version: '2.0.0',
|
|
24
24
|
},
|
|
25
25
|
{
|
|
26
26
|
capabilities: {
|
|
@@ -93,6 +93,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
|
|
|
93
93
|
case 'grid402_kyb_audit':
|
|
94
94
|
service = 'kyb-audit';
|
|
95
95
|
break;
|
|
96
|
+
case 'grid402_get_dossier_360':
|
|
97
|
+
service = 'dossier';
|
|
98
|
+
break;
|
|
96
99
|
case 'grid402_market_snapshot':
|
|
97
100
|
service = 'market-snapshot';
|
|
98
101
|
break;
|
|
@@ -108,6 +111,12 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
|
|
|
108
111
|
case 'grid402_global_markets':
|
|
109
112
|
service = 'global-markets';
|
|
110
113
|
break;
|
|
114
|
+
case 'grid402_extract':
|
|
115
|
+
service = 'extract';
|
|
116
|
+
break;
|
|
117
|
+
case 'grid402_email_verify':
|
|
118
|
+
service = 'email-verify';
|
|
119
|
+
break;
|
|
111
120
|
case 'grid402_pass':
|
|
112
121
|
service = 'pass';
|
|
113
122
|
break;
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "grid402-mcp",
|
|
3
|
-
"version": "
|
|
4
|
-
"description": "Official Model Context Protocol (MCP) Server for Grid402 - The Verifiable Data and x402 Payment Layer for Autonomous AI Agents (
|
|
3
|
+
"version": "2.0.0",
|
|
4
|
+
"description": "Official Model Context Protocol (MCP) Server for Grid402 - The Verifiable Data and HTTP x402 Payment Layer for Autonomous AI Agents (27 MCP Tools: Web-to-Markdown Extractor, Zero-PII Email Verifier, KYB 360 AI Dossier, Financial Markets, Compliance, Global LEI, OFAC AML, Network Audits) with gasless PayAI x402 across Base, Polygon, Arbitrum 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 27 ferramentas no padrão MCP (25 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 25 micro-serviços do Grid402 (gratuito, sem cobrança x402).',
|
|
16
16
|
inputSchema: {
|
|
17
17
|
type: 'object',
|
|
18
18
|
properties: {},
|
|
@@ -121,7 +121,7 @@ export const MCP_TOOLS_DEFINITIONS = [
|
|
|
121
121
|
},
|
|
122
122
|
{
|
|
123
123
|
name: 'grid402_kyb_audit',
|
|
124
|
-
description: '
|
|
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
125
|
inputSchema: {
|
|
126
126
|
type: 'object',
|
|
127
127
|
properties: {
|
|
@@ -137,6 +137,24 @@ export const MCP_TOOLS_DEFINITIONS = [
|
|
|
137
137
|
required: ['cnpj'],
|
|
138
138
|
},
|
|
139
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
|
+
},
|
|
140
158
|
{
|
|
141
159
|
name: 'grid402_market_snapshot',
|
|
142
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).',
|
|
@@ -371,6 +389,46 @@ export const MCP_TOOLS_DEFINITIONS = [
|
|
|
371
389
|
required: [],
|
|
372
390
|
},
|
|
373
391
|
},
|
|
392
|
+
{
|
|
393
|
+
name: 'grid402_extract',
|
|
394
|
+
description: 'Extrai páginas web públicas HTTP/HTTPS com proteção SSRF e devolve Markdown limpo pronto para LLMs e RAG, incluindo título, descrição e links absolutos (0.0050 USDC / 1 crédito).',
|
|
395
|
+
inputSchema: {
|
|
396
|
+
type: 'object',
|
|
397
|
+
properties: {
|
|
398
|
+
url: {
|
|
399
|
+
type: 'string',
|
|
400
|
+
description: 'URL pública HTTP ou HTTPS a ser extraída para Markdown limpo (ex: "https://example.com").',
|
|
401
|
+
},
|
|
402
|
+
max_chars: {
|
|
403
|
+
type: 'integer',
|
|
404
|
+
description: 'Limite opcional de caracteres no Markdown retornado (500 a 25000; padrão: 12000).',
|
|
405
|
+
},
|
|
406
|
+
payment_tx_hash: {
|
|
407
|
+
type: 'string',
|
|
408
|
+
description: 'Hash opcional de transação USDC ou token pass_g402_...',
|
|
409
|
+
},
|
|
410
|
+
},
|
|
411
|
+
required: ['url'],
|
|
412
|
+
},
|
|
413
|
+
},
|
|
414
|
+
{
|
|
415
|
+
name: 'grid402_email_verify',
|
|
416
|
+
description: 'Audita entregabilidade de e-mail B2B estritamente Zero-PII: sintaxe RFC, DNS MX, SPF, DMARC, detecção de domínio descartável (disposable), provedor gratuito e role-based (0.0050 USDC / 1 crédito).',
|
|
417
|
+
inputSchema: {
|
|
418
|
+
type: 'object',
|
|
419
|
+
properties: {
|
|
420
|
+
email: {
|
|
421
|
+
type: 'string',
|
|
422
|
+
description: 'Endereço de e-mail a auditar sem armazenamento em disco (ex: "contato@grid402.online").',
|
|
423
|
+
},
|
|
424
|
+
payment_tx_hash: {
|
|
425
|
+
type: 'string',
|
|
426
|
+
description: 'Hash opcional de transação USDC ou token pass_g402_...',
|
|
427
|
+
},
|
|
428
|
+
},
|
|
429
|
+
required: ['email'],
|
|
430
|
+
},
|
|
431
|
+
},
|
|
374
432
|
{
|
|
375
433
|
name: 'grid402_pass',
|
|
376
434
|
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_...',
|
|
@@ -462,6 +520,11 @@ export async function executeGrid402Request(service, params = {}, options = {})
|
|
|
462
520
|
path = '/api/v1/kyb-audit';
|
|
463
521
|
if (params.cnpj) queryParams.set('cnpj', params.cnpj);
|
|
464
522
|
break;
|
|
523
|
+
case 'dossier':
|
|
524
|
+
case 'get_dossier_360':
|
|
525
|
+
path = '/api/v1/dossier';
|
|
526
|
+
if (params.cnpj) queryParams.set('cnpj', params.cnpj);
|
|
527
|
+
break;
|
|
465
528
|
case 'market-snapshot':
|
|
466
529
|
case 'market_snapshot':
|
|
467
530
|
path = '/api/v1/market-snapshot';
|
|
@@ -523,6 +586,16 @@ export async function executeGrid402Request(service, params = {}, options = {})
|
|
|
523
586
|
if (params.base) queryParams.set('base', params.base);
|
|
524
587
|
if (params.date) queryParams.set('date', params.date);
|
|
525
588
|
break;
|
|
589
|
+
case 'extract':
|
|
590
|
+
path = '/api/v1/extract';
|
|
591
|
+
if (params.url) queryParams.set('url', params.url);
|
|
592
|
+
if (params.max_chars !== undefined && params.max_chars !== null) queryParams.set('max_chars', String(params.max_chars));
|
|
593
|
+
break;
|
|
594
|
+
case 'email-verify':
|
|
595
|
+
case 'email_verify':
|
|
596
|
+
path = '/api/v1/email-verify';
|
|
597
|
+
if (params.email) queryParams.set('email', params.email);
|
|
598
|
+
break;
|
|
526
599
|
case 'pass':
|
|
527
600
|
path = '/api/v1/pass';
|
|
528
601
|
if (params.status) queryParams.set('status', params.status);
|
|
@@ -547,7 +620,7 @@ export async function executeGrid402Request(service, params = {}, options = {})
|
|
|
547
620
|
headers: {
|
|
548
621
|
'Content-Type': 'application/json',
|
|
549
622
|
'Accept': 'application/json',
|
|
550
|
-
'User-Agent': 'Grid402-MCP-Server/
|
|
623
|
+
'User-Agent': 'Grid402-MCP-Server/2.0.0',
|
|
551
624
|
},
|
|
552
625
|
body: postPayload,
|
|
553
626
|
});
|
|
@@ -559,7 +632,7 @@ export async function executeGrid402Request(service, params = {}, options = {})
|
|
|
559
632
|
|
|
560
633
|
const headers = {
|
|
561
634
|
'Accept': 'application/json',
|
|
562
|
-
'User-Agent': 'Grid402-MCP-Server/
|
|
635
|
+
'User-Agent': 'Grid402-MCP-Server/2.0.0',
|
|
563
636
|
};
|
|
564
637
|
|
|
565
638
|
if (params.idempotency_key) {
|