XRPLMe Economic Data

Acesse dados econômicos de 30 países para agentes de IA via protocolo MCP

Servidor MCP hospedado

npx add-mcp 'https://api.xrplme.online/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

xrplme-mcp-client

Status: LIVE. O servidor MCP está disponível publicamente em https://api.xrplme.online/mcp — anônimo, sem necessidade de token para o nível gratuito de descoberta. Rotas premium por país são cobradas por consulta via x402 no XRP Ledger.

Exemplos de clientes e guias de integração para o servidor MCP XRPLME Country Data — dados econômicos e políticos de 30 países para agentes de IA, com um nível gratuito de descoberta e rotas premium x402 com pagamento por consulta.

O que é isto

Agentes de IA são bons em raciocínio e ruins em acesso. Dados econômicos confiáveis, atuais e por país (PIB, inflação, desemprego, comércio, políticas) estão espalhados por dezenas de escritórios nacionais de estatística, bancos centrais e bases de dados multilaterais — cada um com seu próprio formato, cadência e disponibilidade. Agentes que precisam desses dados acabam ou fazendo scraping de HTML frágil ou raciocinando com dados de treinamento desatualizados.

A XRPLME expõe esses dados como um servidor Model Context Protocol (MCP), para que qualquer cliente compatível com MCP (Claude Desktop, Cursor, agentes personalizados) possa consultá-lo como uma ferramenta de primeira classe. Pagamentos para rotas premium usam x402 — nativo de HTTP, pagamento por consulta, liquidado no XRP Ledger. Sem contas, sem venda de chaves de API.

Transporte: HTTP streamable
Endpoint: https://api.xrplme.online/mcp (ativo, anônimo)
Cobertura: 30 países
Autenticação: nenhuma para o nível gratuito de descoberta
Premium: x402, 0,1–0,5 XRP por consulta

Início rápido

1. Aponte um cliente para o servidor

Nenhum token é necessário. O caminho mais rápido é mcp-remote, que permite que qualquer cliente MCP somente stdio converse com um servidor HTTP remoto:

{
  "mcpServers": {
    "xrplme-country-data": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.xrplme.online/mcp"]
    }
  }
}

Veja examples/ para clientes Claude Desktop / Cursor, Python e Node.

2. Faça uma pergunta

"Usando as ferramentas xrplme, compare inflação e desemprego para Tailândia, Vietnã e Indonésia no último ano disponível."

O agente chama xrplme_get_country_data internamente e responde com números citados e com carimbo de data/hora.

Superfície disponível

Recursos (somente leitura, endereçáveis):

URI	Retorna
`xrplme://countries`	Os 30 slugs de países suportados
`xrplme://status`	Status de cobertura + frescor dos dados por país

Ferramentas (8, todas somente leitura, exceto o envio opcional de pesquisa):

Ferramenta	Finalidade
`xrplme_list_countries`	Enumera os 30 slugs, com estado de frescor
`xrplme_get_country_status`	Frescor por país + status de disponibilidade
`xrplme_get_pricing`	Consulta de preços (sem chamada upstream)
`xrplme_get_country_data`	Busca os registros validados mais recentes de um país
`xrplme_get_country_schema`	Esquema de registros para um país
`xrplme_get_survey_questions`	Recupera as perguntas da pesquisa de qualidade de dados
`xrplme_submit_survey`	Envia respostas da pesquisa
`xrplme_get_survey_stats`	Agrega estatísticas da pesquisa

Cada resposta carrega metadados de frescor: age_hours, state (fresh / overdue / stale_beyond_max) e scraped_at. Os dados são atualizados diariamente; state informa se você está vendo algo recente.

Pagando com x402 (rotas premium)

Algumas rotas retornam 402 Payment Required com cabeçalhos x402. Seu cliente paga em XRP e tenta novamente com prova de pagamento — sem cadastro.

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

Passo a passo completo: examples/x402_payment.py.

O nível de descoberta é gratuito e não requer pagamento. Você só usa x402 para rotas premium por país. Os preços são descobríveis sem pagar via xrplme_get_pricing.

Exemplos

Arquivo	O que mostra
`examples/claude_desktop_config.json`	Configuração do Claude Desktop / Cursor
`examples/python_client.py`	Cliente Python via SDK MCP
`examples/node_client.js`	Cliente Node.js
`examples/x402_payment.py`	Fluxo 402 → pagar → tentar novamente

Veja examples/README.md para configuração por exemplo.

Cobertura de dados

30 países na APAC, Europa e Américas. O conjunto de dados de cada país é atualizado diariamente a partir das fontes oficiais do próprio governo e financeiras do país, e depois validado antes da publicação (um conjunto de dados candidato só é promovido se atender a um limite de qualidade por país). xrplme://status relata o estado atual de frescor de todos os países.

O frescor é explícito, nunca implícito. Se a fonte upstream de um país estiver indisponível, o servidor continua servindo o último conjunto de dados validado e relata a idade real — ele não substitui silenciosamente.

Licença

MIT — veja LICENSE.

Os dados servidos vêm de fontes públicas de terceiros com seus próprios termos e requisitos de atribuição; consulte o source_url em cada registro.