grid402-mcp 1.8.2 → 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 +28 -15
- package/index.mjs +9 -6
- package/package.json +2 -2
- package/tools.mjs +26 -3
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 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';
|
|
@@ -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
|
|
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 (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
18
|
].join(' ');
|
|
19
19
|
|
|
20
20
|
const server = new Server(
|
|
21
21
|
{
|
|
22
22
|
name: 'grid402-mcp-server',
|
|
23
|
-
version: '1.
|
|
23
|
+
version: '1.9.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;
|
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 - The Verifiable Data and x402 Payment Layer for Autonomous AI Agents (
|
|
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: {},
|
|
@@ -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).',
|
|
@@ -462,6 +480,11 @@ export async function executeGrid402Request(service, params = {}, options = {})
|
|
|
462
480
|
path = '/api/v1/kyb-audit';
|
|
463
481
|
if (params.cnpj) queryParams.set('cnpj', params.cnpj);
|
|
464
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;
|
|
465
488
|
case 'market-snapshot':
|
|
466
489
|
case 'market_snapshot':
|
|
467
490
|
path = '/api/v1/market-snapshot';
|