SelectaRank Data Gateway MCP

selectarank-mcp

Servidor MCP (stdio) para o SelectaRank Data Gateway, uma API paga por chamada que usa o protocolo x402 com USDC na Base. Ele permite que um agente de IA descubra os endpoints pagos do gateway como ferramentas MCP e, se você fornecer uma chave de carteira, pague por eles automaticamente.

Nome no Registro MCP: io.github.selectarank/selectarank-mcp

Ferramentas

As ferramentas são geradas a partir do /openapi.json do gateway na inicialização (uma cópia embutida da lista é usada se não puder ser obtida).

Ferramenta	Endpoint	Preço por chamada (USDC)	Fonte de dados
selectarank_earthquakes	GET /v1/earthquakes/{feed}	0.002	USGS
selectarank_weather	GET /v1/weather/{lat}/{lon} (somente EUA)	0.003	NOAA/NWS
selectarank_worldbank	GET /v1/worldbank/{country}/{indicator}	0.002	Banco Mundial
selectarank_jgbYields	GET /v1/jp/jgb-yields?days=	0.002	Curva de juros dos títulos do governo japonês 1A-40A (Ministério das Finanças, PDL 1.0)
selectarank_ustYields	GET /v1/us/treasury-yields?days=	0.002	Curva de juros par dos títulos do Tesouro dos EUA (Tesouro dos EUA)
selectarank_ecbFx	GET /v1/eu/ecb-fx?currencies=&days=	0.002	Taxas de câmbio de referência do euro do BCE
selectarank_secFilings	GET /v1/us/sec/filings/{cik}	0.003	Registros recentes do SEC EDGAR por CIK, com URLs de documentos
selectarank_preflight	GET /v1/preflight?url=	0.010	Verifica o desafio 402 de outro endpoint x402 (um GET não autenticado, sem movimentação de fundos)

As ferramentas de dados (terremotos, clima, Banco Mundial, rendimentos JGB/EUA, câmbio BCE, registros SEC) retornam dados upstream de domínio público com metadados de fonte e licença. O gateway é um intermediário; ele não produz seus próprios dados.

Pagamento

• Rede: Base mainnet (eip155:8453), esquema exact
• Ativo: USDC, 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
• Destinatário (payTo): 0x57a0c0b413516BbF3Fcdb88408D59B7809e3efd0

Sempre verifique essas informações contra a resposta 402 ao vivo; o servidor retorna os PaymentRequirements reais do gateway.

Instalação

Requer Node.js 18+.

{
  "mcpServers": {
    "selectarank": {
      "command": "npx",
      "args": ["-y", "github:selectarank/selectarank-mcp"],
      "env": { "EVM_PRIVATE_KEY": "0x..." }
    }
  }
}

Omita env para executar sem pagar (veja abaixo). Instalado diretamente do GitHub por enquanto; ainda não foi publicado no npm.

Variáveis de ambiente

Variável	Obrigatória	Significado
EVM_PRIVATE_KEY	não	Chave privada de uma carteira com USDC na Base. Com ela, as chamadas de ferramentas pagam automaticamente via @x402/fetch. Use uma carteira dedicada com saldo baixo. Nunca é commitada ou registrada por este pacote.
SELECTARANK_MAX_PRICE_USDC	não	Recusa pagamento automático acima deste valor por chamada. Padrão 0.05.
SELECTARANK_BASE_URL	não	Substitui a URL do gateway. Padrão https://selectarank-data.vercel.app.

Comportamento sem chave

Sem EVM_PRIVATE_KEY, o servidor ainda inicia e lista todas as ferramentas. Chamar uma ferramenta faz uma solicitação não paga e retorna os PaymentRequirements 402 (valor, ativo, payTo, rede) além de instruções para pagamento. Nada é gasto.

Status e limites

• Vendas até o momento: 0. Este é um serviço novo.
• Os dados vêm de USGS, NOAA/NWS e do Banco Mundial; frescor e precisão são de responsabilidade deles. Sem SLA.
• Você é responsável pelos fundos na carteira que configurar.

Desenvolvimento

npm install
npm run build
npm run typecheck

Licença

MIT