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).
| Herramienta | Endpoint | Precio por llamada (USDC) | Fuente de datos |
|---|---|---|---|
selectarank_earthquakes | GET /v1/earthquakes/{feed} | 0.002 | USGS |
selectarank_weather | GET /v1/weather/{lat}/{lon} (solo EE. UU.) | 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 rendimiento de bonos del gobierno japonés 1A-40A (Ministerio de Finanzas, PDL 1.0) |
selectarank_ustYields | GET /v1/us/treasury-yields?days= | 0.002 | Curva de rendimiento par del Tesoro de EE. UU. (Tesoro de EE. UU.) |
selectarank_ecbFx | GET /v1/eu/ecb-fx?currencies=&days= | 0.002 | Tipos de cambio de referencia del euro del BCE |
selectarank_secFilings | GET /v1/us/sec/filings/{cik} | 0.003 | Presentaciones recientes de SEC EDGAR por CIK, con URLs de documentos |
selectarank_preflight | GET /v1/preflight?url= | 0.010 | Comprueba 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), esquemaexact - 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
| Variable | Requerida | Significado |
|---|---|---|
EVM_PRIVATE_KEY | no | Clave 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_USDC | no | Rechaza el pago automático por encima de este monto por llamada. Por defecto 0.05. |
SELECTARANK_BASE_URL | no | Sobrescribe 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