XRPLMe Economic Data
Accede a datos económicos de 30 países para agentes de IA mediante el protocolo MCP.
Servidor MCP alojado
npx add-mcp 'https://api.xrplme.online/mcp'Se instala en Claude Code, Codex, Cursor y más
Documentación
xrplme-mcp-client
Estado: EN VIVO. El servidor MCP está disponible públicamente en
https://api.xrplme.online/mcp— anónimo, sin token requerido para el nivel gratuito de descubrimiento. Las rutas premium por país se liquidan por consulta vía x402 en el XRP Ledger.
Clientes de ejemplo y guías de integración para el servidor MCP XRPLME Country Data — datos económicos y de políticas de 30 países para agentes de IA, con un nivel gratuito de descubrimiento y rutas premium de pago por consulta vía x402.
Qué es esto
Los agentes de IA son buenos razonando y malos accediendo. Los datos económicos confiables y actuales por país (PIB, inflación, desempleo, comercio, políticas) están dispersos en docenas de oficinas nacionales de estadística, bancos centrales y bases de datos multilaterales — cada una con su propio formato, cadencia y disponibilidad. Los agentes que los necesitan terminan o raspando HTML frágil o razonando con datos de entrenamiento desactualizados.
XRPLME expone esos datos como un servidor Model Context Protocol (MCP), para que cualquier cliente compatible con MCP (Claude Desktop, Cursor, agentes personalizados) pueda consultarlo como una herramienta de primera clase. Los pagos para rutas premium usan x402 — nativo de HTTP, pago por consulta, liquidado en el XRP Ledger. Sin cuentas, sin venta de claves API.
- Transporte: HTTP transmisible
- Endpoint:
https://api.xrplme.online/mcp(en vivo, anónimo) - Cobertura: 30 países
- Autenticación: ninguna para el nivel gratuito de descubrimiento
- Premium: x402, 0.1–0.5 XRP por consulta
Inicio rápido
1. Apunta un cliente al servidor
No se necesita token. El camino más rápido es mcp-remote, que permite que cualquier cliente MCP
solo-stdio hable con un servidor HTTP remoto:
{
"mcpServers": {
"xrplme-country-data": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.xrplme.online/mcp"]
}
}
}
Consulta examples/ para clientes de Claude Desktop / Cursor, Python y Node.
2. Haz una pregunta
"Usando las herramientas de xrplme, compara inflación y desempleo para Tailandia, Vietnam e Indonesia en el último año disponible."
El agente llama a xrplme_get_country_data internamente y responde con cifras citadas y con marca de tiempo.
Superficie disponible
Recursos (solo lectura, direccionables):
| URI | Devuelve |
|---|---|
xrplme://countries | Los 30 slugs de países soportados |
xrplme://status | Estado de cobertura + frescura de datos por país |
Herramientas (8, todas de solo lectura excepto el envío opcional de encuestas):
| Herramienta | Propósito |
|---|---|
xrplme_list_countries | Enumerar los 30 slugs, con estado de frescura |
xrplme_get_country_status | Frescura por país + estado de disponibilidad |
xrplme_get_pricing | Consulta de precios (sin llamada ascendente) |
xrplme_get_country_data | Obtener los registros validados más recientes de un país |
xrplme_get_country_schema | Esquema de registros para un país |
xrplme_get_survey_questions | Recuperar las preguntas de la encuesta de calidad de datos |
xrplme_submit_survey | Enviar respuestas de la encuesta |
xrplme_get_survey_stats | Estadísticas agregadas de la encuesta |
Cada respuesta lleva metadatos de frescura: age_hours, state
(fresh / overdue / stale_beyond_max), y scraped_at. Los datos se actualizan
diariamente; state te dice si estás viendo algo reciente.
Pagar con x402 (rutas premium)
Algunas rutas devuelven 402 Payment Required con encabezados x402. Tu cliente paga en
XRP y reintenta con prueba de pago — sin registro.
POST /mcp → 402 (X402-Payment-Required, X402-Price, X402-Asset, X402-Payment-Address)
↓ pay 0.1 XRP on XRPL
POST /mcp + X-PAYMENT-SIGNATURE + X-INV-ID → 200 OK
Guía completa: examples/x402_payment.py.
El nivel de descubrimiento es gratuito y no requiere pago. Solo tocas x402 para rutas premium por país. Los precios son descubribles sin pagar vía
xrplme_get_pricing.
Ejemplos
| Archivo | Qué muestra |
|---|---|
examples/claude_desktop_config.json | Configuración de Claude Desktop / Cursor |
examples/python_client.py | Cliente Python vía el SDK de MCP |
examples/node_client.js | Cliente Node.js |
examples/x402_payment.py | Flujo 402 → pagar → reintentar |
Consulta examples/README.md para la configuración de cada ejemplo.
Cobertura de datos
30 países en APAC, Europa y las Américas. El conjunto de datos de cada país se
actualiza diariamente desde las fuentes oficiales gubernamentales y financieras
de ese país, y luego se valida antes de la publicación (un conjunto de datos candidato solo se promueve
si cumple con un umbral de calidad por país). xrplme://status informa el
estado de frescura actual de cada país.
La frescura es explícita, nunca implícita. Si la fuente ascendente de un país ha estado no disponible, el servidor sigue sirviendo el último conjunto de datos validado y informa la edad real — no sustituye silenciosamente.
Licencia
MIT — consulta LICENSE.
Los datos servidos provienen de fuentes públicas de terceros con sus propios términos y
requisitos de atribución; consulta el source_url en cada registro.
Enlaces
- Sitio web: https://xrplme.online
- Desarrolladores: https://xrplme.online/developers
- Problemas: usa el rastreador de problemas de este repositorio