SelectaRank Data Gateway MCP

Servidor MCP (stdio) para la puerta de enlace de datos SelectaRank x402. Las herramientas se generan desde el OpenAPI de la puerta de enlace: terremotos del USGS, clima de NOAA/NWS, indicadores del Banco Mundial, una verificación previa del endpoint x402 y más. Pago por llamada ($0.002-$0.01) en USDC en Base. Sin una clave de billetera, lista las herramientas y devuelve los requisitos de pago sin pagar.

Documentación

selectarank-mcp

Servidor MCP (stdio) para el SelectaRank Data Gateway, una API de pago por llamada que utiliza el protocolo x402 con USDC en Base. Permite que un agente de IA descubra los endpoints de pago del gateway como herramientas MCP y, si le proporcionas una clave de wallet, pague por ellos automáticamente.

Nombre en el registro MCP: io.github.selectarank/selectarank-mcp

Herramientas

Las herramientas se generan a partir del /openapi.json del gateway al iniciar (se utiliza una copia integrada de la lista si no se puede obtener).

HerramientaEndpointPrecio por llamada (USDC)Fuente de datos
selectarank_earthquakesGET /v1/earthquakes/{feed}0.002USGS
selectarank_weatherGET /v1/weather/{lat}/{lon} (solo EE. UU.)0.003NOAA/NWS
selectarank_worldbankGET /v1/worldbank/{country}/{indicator}0.002Banco Mundial
selectarank_jgbYieldsGET /v1/jp/jgb-yields?days=0.002Curva de rendimiento de bonos del gobierno japonés 1A-40A (Ministerio de Finanzas, PDL 1.0)
selectarank_ustYieldsGET /v1/us/treasury-yields?days=0.002Curva de rendimiento par del Tesoro de EE. UU. (Tesoro de EE. UU.)
selectarank_ecbFxGET /v1/eu/ecb-fx?currencies=&days=0.002Tipos de cambio de referencia del euro del BCE
selectarank_secFilingsGET /v1/us/sec/filings/{cik}0.003Presentaciones recientes de SEC EDGAR por CIK, con URLs de documentos
selectarank_preflightGET /v1/preflight?url=0.010Comprueba el desafío 402 de otro endpoint x402 (una GET no autenticada, sin movimiento de fondos)

Las herramientas de datos (terremotos, clima, Banco Mundial, rendimientos JGB/US, FX del BCE, presentaciones SEC) devuelven datos upstream de dominio público envueltos con metadatos de fuente y licencia. El gateway es un passthrough; no produce sus propios datos.

Pago

  • Red: Base mainnet (eip155:8453), esquema exact
  • Activo: USDC, 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
  • Destinatario (payTo): 0x57a0c0b413516BbF3Fcdb88408D59B7809e3efd0

Verifica siempre estos datos contra la respuesta 402 en vivo; el servidor devuelve los PaymentRequirements reales del gateway.

Instalación

Requiere Node.js 18+.

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

Omite env para ejecutar sin pagar (ver más abajo). Se instala directamente desde GitHub por ahora; aún no está publicado en npm.

Variables de entorno

VariableRequeridaSignificado
EVM_PRIVATE_KEYnoClave privada de una wallet con USDC en Base. Con ella, las llamadas a herramientas pagan automáticamente vía @x402/fetch. Usa una wallet dedicada con saldo bajo. Este paquete nunca la confirma ni la registra.
SELECTARANK_MAX_PRICE_USDCnoRechaza el pago automático por encima de este monto por llamada. Por defecto 0.05.
SELECTARANK_BASE_URLnoSobrescribe la URL del gateway. Por defecto https://selectarank-data.vercel.app.

Comportamiento sin clave

Sin EVM_PRIVATE_KEY el servidor igualmente se inicia y lista todas las herramientas. Llamar a una herramienta realiza una solicitud no pagada y devuelve los PaymentRequirements 402 (monto, activo, payTo, red) más instrucciones para pagar. No se gasta nada.

Estado y límites

  • Ventas hasta la fecha: 0. Este es un servicio nuevo.
  • Los datos provienen de USGS, NOAA/NWS y el Banco Mundial; la frescura y precisión son de ellos. Sin SLA.
  • Eres responsable de los fondos en la wallet que configures.

Desarrollo

npm install
npm run build
npm run typecheck

Licencia

MIT