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.
Files changed (4) hide show
  1. package/README.md +28 -15
  2. package/index.mjs +15 -6
  3. package/package.json +2 -2
  4. 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 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.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 |
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 3 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).
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 24 tools for real-time open data and M2M network utilities with Base x402 settlement.
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 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`).',
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: '1.8.2',
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": "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.",
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 24 ferramentas no padrão MCP (22 micro-serviços + summary + pass_balance)
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 22 micro-serviços do Grid402 (gratuito, sem cobrança x402).',
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: '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).',
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/1.8',
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/1.8',
635
+ 'User-Agent': 'Grid402-MCP-Server/2.0.0',
563
636
  };
564
637
 
565
638
  if (params.idempotency_key) {