Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

Lumi Trades: x402 seller checks and test-buys

de lumitradesversión 0.9.9i★ 0iComputadora o nubeSitio oficial ↗
Nombre en el registroio.github.cypher-osiris/lumi-trades-mcp

Cómo instalar

What it does

Free signed allow/warn/block before paying x402 sellers; test-buys on XRPL, Base and Stellar

  • Connects Computadora o nube
  • Account or key Cloud: No key needed · Local: Needs EVM_PRIVATE_KEY, XRPL_SEED
  • Category Otros

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad0/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo8/8El endpoint en la nube respondió en la última revisión
Puntuación de uso20/100

Calidad: Pasó 4/5 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala Lumi Trades: x402 seller checks and test-buys. Sigue https://mcp.popnx.com/i/cypher-osiris-lumi-trades-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 4/5 revisiones · Lo que preguntas pasa por el servidor del autor (api.lumitrades.io) · ✓ Comandos revisados el 14 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude · unos 2 min

Sin clave y sin instalar nada · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner

  1. Abre la página Connectors de Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Pulsa “Add” → “Custom” → “Web” y completa estos 2 campos

    Copia cada valor al campo con el mismo nombre en Claude y pulsa Continue

    Name · NombreLumi Trades: x402 seller checks and test-buys
    Remote MCP server URL · Direcciónhttps://api.lumitrades.io/mcp

    Pulsa Continue en la pantalla de inicio de sesión que detectó Claude · en Authentication elige lo que indique el autor (Sign in now, Sign in when needed o No sign in) y pulsa Add

  3. Actívalo en un chat

    +ConnectorsLumi Trades: x402 seller checks and test-buys

  4. Pruébalo

    Usa Lumi Trades: x402 seller checks and test-buys y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Lumi Trades: x402 seller checks and test-buys o muestra una herramienta de Lumi Trades: x402 seller checks and test-buys en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con ChatGPT según tu plan

MCP completo: ChatGPT Business, Enterprise o Edu en la web · Pro: conecta con permisos de lectura/obtención, así que las herramientas que cambian datos pueden no funcionar · Plus: no confirmado en la documentación; si ves una opción para añadir MCP propio en la página de plugins puedes probar · solo web

  1. Abre la página para añadir MCP en ChatGPT web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Escribe el nombre y la dirección

    Pon un nombre, pega la dirección en Connection, marca el aviso de riesgo y pulsa Create as a plugin

    Name · NombreLumi Trades: x402 seller checks and test-buys
    Connection · Direcciónhttps://api.lumitrades.io/mcp
  3. Elige Lumi Trades: x402 seller checks and test-buys en un chat

    Abre un chat nuevo y elige Lumi Trades: x402 seller checks and test-buys en tus plugins antes de escribir

  4. Pruébalo

    Usa Lumi Trades: x402 seller checks and test-buys y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si ChatGPT dice que está usando Lumi Trades: x402 seller checks and test-buys o muestra una herramienta de Lumi Trades: x402 seller checks and test-buys en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de OpenAI el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Claude Code · unos 2 min

Sin clave y sin instalar nada

  1. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  2. Pega este comando y pulsa Enter

    claude mcp add --transport http --scope user lumi-trades https://api.lumitrades.io/mcp
  3. Escribe /mcp en Claude Code

    Deberías ver Lumi Trades: x402 seller checks and test-buys en la lista como conectado

  4. Pruébalo

    Usa Lumi Trades: x402 seller checks and test-buys y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Lumi Trades: x402 seller checks and test-buys o muestra una herramienta de Lumi Trades: x402 seller checks and test-buys en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de Cursor en modo Agent

  3. Pruébalo

    Usa Lumi Trades: x402 seller checks and test-buys y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Lumi Trades: x402 seller checks and test-buys o muestra una herramienta de Lumi Trades: x402 seller checks and test-buys en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de VS Code en modo Agent

  3. Pruébalo

    Usa Lumi Trades: x402 seller checks and test-buys y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Lumi Trades: x402 seller checks and test-buys o muestra una herramienta de Lumi Trades: x402 seller checks and test-buys en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

Dirección para apps que se conectan por la web

Direcciónhttps://api.lumitrades.io/mcp

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Lumi Trades: x402 seller checks and test-buys💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Por la web

Claude Code

claude mcp add --transport http --scope user lumi-trades https://api.lumitrades.io/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "lumi-trades": {
      "url": "https://api.lumitrades.io/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "lumi-trades": {
      "type": "http",
      "url": "https://api.lumitrades.io/mcp"
    }
  }
}

Instalado en tu computadora

Claude Code

claude mcp add --scope user lumi-trades --env EVM_PRIVATE_KEY=your-value --env XRPL_SEED=your-value -- npx -y lumi-trades-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "lumi-trades": {
      "command": "npx",
      "args": [
        "-y",
        "lumi-trades-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "your-value",
        "XRPL_SEED": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "lumi-trades": {
      "command": "npx",
      "args": [
        "-y",
        "lumi-trades-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "your-value",
        "XRPL_SEED": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "lumi-trades": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "lumi-trades-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "your-value",
        "XRPL_SEED": "your-value"
      }
    }
  }
}

Valores que debes completar

  • EVM_PRIVATE_KEY secreto obligatorio env
    0x private key of your Base wallet that pays in USDC (gasless, signed locally)
  • XRPL_SEED secreto obligatorio env
    Semilla de tu billetera XRPL que paga en XRP/RLUSD/USDC (firmada localmente)
    Ver original en inglésSeed of your XRPL wallet that pays in XRP/RLUSD/USDC (signed locally)
  • LUMI_PAY_ASSET env
    BASE_USDC, XRP, RLUSD or USDC (XRPL). Default: XRP if XRPL_SEED set, else BASE_USDC
  • LUMI_MAX_USD_PER_CALL env
    Límite por llamada en USD para stablecoins (cubre todos los endpoints de Lumi).
    Ver original en inglésPer-call cap in USD for stablecoins (covers every Lumi endpoint)
  • LUMI_MAX_XRP_PER_CALL env
    Límite por llamada en XRP.
    Ver original en inglésPer-call cap in XRP
  • LUMI_SESSION_BUDGET env
    Gasto total máximo por proceso del servidor.
    Ver original en inglésMax total spend per server process
  • XRPL_NETWORK env
    xrpl:0 para mainnet o xrpl:1 para testnet
    Ver original en inglésxrpl:0 mainnet or xrpl:1 testnet

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
163/sem
Conexión
Computadora o nube
Transporte
stdio, streamable-http
Última versióni
0.9.9
Categoríai
Otros
Publicado en el registroi
26 oct 2026
Último cambio de códigoi
13 nov 2026
Última revisión
18 nov 2026
Creador
lumitrades
Paquetes
npm: lumi-trades-mcp
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se conectan por internet en

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Nombres y descripciones de las herramientas tal como los informó el servidor el 18 nov 2026. Los escribió el creador, no nosotros; los mostramos como texto sin formato.

  • lumi_trust_check

    Free (rate-limited per client and per day). Should I pay this x402 URL? Start here before any paid tool. One label (checks_passed / check_first / checks_failed / no_data) plus the allow / warn / block verdict with coded reasons, from Lumi's daily CDP Bazaar index, free 402-quote

  • lumi_wallet_check

    Free (rate-limited, 100 a day). Pass a public wallet address (Base 0x..., XRP Ledger r... or Stellar G...) to list the x402 sellers that wallet paid in the last 90 days, each with the same plain summary line as lumi_trust_check (how many times Lumi test-bought it and how many del

  • lumi_catalog

    Free. Lists Lumi API endpoints, live prices (XRP / RLUSD / USDC on the XRP Ledger, USDC on Base, USDC on Stellar), payment settings of this MCP server and the caller wallet address.

  • lumi_samples

    Free. A truncated, clearly labelled SAMPLE of each paid product (high_value_check, vendor report) with its USD price and full URL, so you can see the shape and quality before paying. Lists are cut to 2 entries; up to 10 minutes old. Pass route to get one product.

  • lumi_quote

    Free. Shows the x402 price quote (XRP / RLUSD / USDC on the XRP Ledger, USDC on Base, USDC on Stellar) for any Lumi paid path, e.g. /v1/trust/check/high-value?url=...&amount=10, without paying. A 503 means the data is not fresh right now and the call would not be sold.

  • lumi_vendor_scores

    Free. Check an x402 seller before you pay it: pass url (the resource you are about to buy), domain, or payTo (the address in its 402 quote, case-insensitive). Lumi ingests the full CDP x402 Bazaar catalog daily and runs free, unpaid 402-quote checks of listings on a rotating sche

  • lumi_verdict

    Paid: $0.01 per call over x402 at GET /v1/verdict (this tool returns the price terms; the free lumi_trust_check and the free signed /v1/check have the same data, so try them first). Before paying an x402 URL or seller domain: one label from the same data and signing key as /v1/ch

  • lumi_seller_monitoring

    Free. Seller monitoring for x402 sellers: Watch and Watch Pro plans per endpoint per 30 days, a one-off audit, test-buy packs, a free Watch tier and a 14-day Watch trial (prices are returned by this tool and in each 402). No auto-renew; payTo proven by signature; paying never cha

  • lumi_trust_feed

    Free. Licensed trust data feed for facilitators, wallets and frameworks: a free key with a monthly lookup allowance (wallet signature), metered extra lookups, and Feed and Feed Pro plans (snapshot export, webhooks). Returns plans, prices, endpoints and licence terms (no resale, a

  • lumi_high_value_check

    Paid: 0.5% of the stated amount, min $0.005, max $0.25 (e.g. $0.05 for amount=10), per call over x402. Before a larger x402 payment: the same label, allow / warn / block verdict and score as the free lumi_trust_check (paying never changes them), plus a live re-check of the seller

  • lumi_vendor_report

    Detailed report on one x402 vendor from Lumi's trust list: full observation history (every free 402-quote check over 90 days, every paid test-buy with tx hash and delivered yes/no), latency stats and 7-day trend, uptime % (24h/7d/30d/90d) and daily series, quoted-price history, a

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026

  • ! Precaución

    El creador coincide con el repo

    Quien lo publicó (cypher-osiris) no es el dueño del repo (lumitrades); puede que otra persona lo haya listado

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 6 días

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • ✓ Superada

    El endpoint responde

    Respondió en 673 ms (HTTP 200)

  • – No aplica

    Inicio de sesión con OAuth

    No hace falta iniciar sesión

  • ✓ Superada

    Sin instrucciones ocultas en las descripciones de herramientas

    Leímos 11 descripciones de herramientas y no encontramos instrucciones ocultas para la IA

Vulnerabilidades publicadas (OSV.dev)

Sin entradas en OSV.dev para lumi-trades-mcp@0.9.9

Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/cypher-osiris-lumi-trades-mcp.svg)](https://mcp.popnx.com/en/servers/cypher-osiris-lumi-trades-mcp)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Otrosi

  • Más estrellas que el 0% de los otros 20653 servidores de esta categoría
  • Publicado en el registro más recientemente que el 64% de los otros 20653 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 59% de los otros 20653 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Lumi Trades: x402 seller checks and test-buys?

Superó 4 de 5 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: EVM_PRIVATE_KEY, XRPL_SEED

¿Se ejecuta en mi computadora o en la nube?

Funciona de las dos formas: instálalo en tu computadora o conéctate a la versión en la nube.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 6 días, y la última versión (0.9.9) llegó al registro hace 24 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también sirve en apps que aceptan MCP remoto, como ChatGPT en la web (MCP completo en Business y superiores; Pro solo lectura).

¿Qué puedo usar en su lugar?

En la misma categoría: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

de koala73Muy usado★ 90,9 milActualizado hace 3 días

Se ejecuta en la nube✓ del servicio · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

de openstatusHQMuy usado★ 9,3 milActualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

de JanDeDobbeleerMuy usado★ 23,8 mil Estrellas de todo el repositorioActualizado hace 30 días

Se ejecuta en la nube✓ del servicio · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

de Klavis-AIEn crecimiento★ 5,8 milActualizado hace 14 meses

Se ejecuta en la nubeRepo archivado✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

de jitsucomMuy usado★ 5,1 milActualizado hace 4 meses

Se ejecuta en la nube✓ del servicio · jitsu.com
Comparado con otros parecidos
Este
Lumi Trades: x402 seller checks and test-buys
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
Dónde se ejecutaEn la nube o instalado en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveSíNoNoNoNoNo
Se añade con + en ClaudeNoNoNoNoNoNo
Revisiones básicas4/54/44/44/41/44/4
LicenciaMITAGPL-3.0AGPL-3.0MITApache-2.0MIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

lumi-trades-mcp

MCP server (stdio) for [Lumi Trades](https://lumitrades.io): Lumi Check, a free signed allow/warn/block check before your agent pays an x402 seller, backed by Lumi's own paid test-buys on XRPL, Base and Stellar: x402 seller trust you can verify. Works with Claude Desktop, Cursor, Claude Code, Cline, Windsurf and any other MCP client. Paid tools pay per call via x402 with your own wallet: USDC on Base (gasless) or XRP / RLUSD / USDC on the XRP Ledger (the API also accepts USDC on Stellar; this package pays only on Base or the XRP Ledger). No API key, no account: each paid tool call is one small payment, signed locally on your machine.

Automated observations by Lumi, not a rating, endorsement or guarantee.

Changed in 0.9.9: this package is now only about checking x402 sellers. Tools for API routes retired on Oct 25, 2026 were removed;

those routes answer 410 Gone and are never charged. Use lumi_check / /v1/check to check a seller before paying.

zod is now required at the patched range (GHSA-mrhx-c7xc-m3w5) for every dependency.

No install needed to browse: the same tools are also served remotely at https://api.lumitrades.io/mcp (Streamable HTTP), for clients that take a remote MCP server URL. A remote connector has no wallet, so its paid tools return the price and how to pay; use this package when you want paid tools to pay automatically from your own wallet.

Tools

General (free)

ToolPaid?Price (USD)What you get
lumi_catalogfree–Endpoints, live prices, this server's wallet + spend caps
lumi_samplesfreeroute?Truncated, labelled samples of every paid product with USD price and full URL
lumi_quotefree–The x402 quote for any paid path, without paying

Lumi Trades seller checks (x402)

ToolPaid?Price (USD)What you get
lumi_verdict$0.01url payTo? amount?One label before paying, same data and signing as /v1/check: checks_passed (Delivered in recent checks) / check_first (Check first) / checks_failed (Recent checks failed) / no_data (Not enough data), with dates, evidence window, sample count, reason codes, evidence and appeal links. Paying Lumi never changes a result
lumi_vendor_scoresfreeurl? domain? payTo? vendor_id?Look up any x402 seller before paying: tier (catalogued / quote-checked, low confidence / test-bought), last free 402-quote check, price and payTo vs its Bazaar listing, on-chain test-buy evidence. No args: Lumi's curated vendor scores
lumi_seller_monitoringfreeenrollment_id?Seller monitoring plans (per endpoint per 30d: Watch $5, Watch Pro $20; 10+ endpoints -20% or 3 terms prepaid -10%, not stacked; Audit $99 one-off; test-buy packs: Re-test $6.50 for 30 test-buys, Founder $5.00 for 24 test-buys, first 10 sellers; free Watch tier; 14-day Watch trial), enrolment steps; with an id, that seller's public entry and badge. Paying never changes a score
lumi_trust_feedfree–Trust data feed plans (free key 1,000 lookups/month, Feed $99/30d, Feed Pro $199/30d) and licence terms
lumi_checkfreeurl? pay_to? amount_usd? network?Lumi Check before you pay any x402 seller: allow / warn / block with reasons, the seller's score and a link to its live report. Signed by Lumi and verified locally. Only origin + path of the URL is sent. Fail-open: warn if Lumi is unreachable within 2.5 s
lumi_scan_sellerfreeurlFetch an x402 seller's 402 quote without paying, plus a dry-run test-buy plan against local caps
lumi_report_receiptfreeendpoint network tx_hash …Sign a receipt for a purchase you already made. submit: true is tier 2 sharing: off by default, needs LUMI_SHARE_RECEIPTS=1 or lumi-scan sharing on. Shares the payment's chain and transaction ID, which is public on-chain and linkable to the paying wallet. Verified receipts earn a public badge only
lumi_trust_checkpaid$0.02Pre-payment check of any x402 URL you are about to pay: payTo/price mismatches vs listings and Lumi's observations. url required
lumi_vendor_reportpaid$0.02Full observation history for one x402 vendor on Lumi's trust list: every quote check (90 days) and paid test-buy with tx hash and delivered yes/no, latency stats and trend, uptime %, agent reports, vendor replies, confidence labels. vendor_id required

How to pay, in order of preference: 1. USDC on Base (gasless, EVM_PRIVATE_KEY), 2. the XRP Ledger (XRPL_SEED): RLUSD or USDC at the same USD price, or XRP at the live XRP/USD rate (quoted per call, rounded up to 0.0001 XRP). Prices are read live from each 402 quote; the table is for orientation. You only pay when you get an answer: the API checks your input before quoting (4xx, nothing charged) and answers 503 "Not charged." when it cannot answer, so a payment is never settled without an answer.

Install

Requires Node 20+. Published on npm as lumi-trades-mcp and in the official MCP Registry as io.github.cypher-osiris/lumi-trades-mcp.

npx -y lumi-trades-mcp
Claude Desktop / Cursor / any MCP client (mcpServers JSON)
{

"mcpServers": { "lumi-trades": { "command": "npx", "args": ["-y", "lumi-trades-mcp"], "env": { "EVM_PRIVATE_KEY": "0x...your Base agent wallet key (holds USDC, no ETH needed)...", "LUMI_MAX_USD_PER_CALL": "0.30", "LUMI_SESSION_BUDGET": "1" } } } }

Paying on the XRP Ledger instead: set "XRPL_SEED": "sEd..." (and optionally "LUMI_PAY_ASSET": "RLUSD" or "USDC", default XRP) in place of EVM_PRIVATE_KEY.

From a clone instead: "command": "node", "args": ["/absolute/path/to/lumi-api/mcp/src/index.js"] (after npm install in mcp/). Claude Code: claude mcp add lumi-trades -e EVM_PRIVATE_KEY=0x... -- npx -y lumi-trades-mcp (or -e XRPL_SEED=sEd...).

Without a wallet the free tools work and paid tools return the price quote instead of paying.

Lumi Check from your own code (x402 / MCP hooks)

import { lumiCheckHooks } from "lumi-trades-mcp/src/check.js";

const { lumi, x402Hook, mcpHook } = await lumiCheckHooks(); // options: { failMode: "open"|"closed", timeoutMs, publicKeys }

x402Client.onBeforePaymentCreation(x402Hook); // @x402 core: returns { abort: true, reason } on "block" mcpClient.onPaymentRequired(mcpHook); // @x402/mcp: returns { abort: true } on "block" (checked by payTo) const v = await lumi.check({ url, payTo, amountUsd: 0.01 }); // { decision, reasons, score, link, verified }

Defaults: fail-open (a timeout or an unverifiable answer gives warn, payment goes ahead) and a 2.5 s timeout. Set failMode: "closed" to block instead. Paying Lumi never changes any seller's score, tier, ranking or badge. The adapters come from lumi-check on npm (Apache-2.0); scoring and verification stay on Lumi's servers.

What the kit shares: nothing until the user says yes. The lumi-scan CLI asks once, after the first check ("Share your results to help improve Lumi's public trust list? [Y/n]"). The MCP server cannot ask, so here sharing stays off and one hint is written to stderr; turn it on with LUMI_CHECK_TELEMETRY=on or lumi-scan telemetry on. Tier 1 is only an anonymous delivery outcome after a paid call: seller host, delivered yes/no, a coarse status class and a random one-time token. No wallet, amount, tx hash, query string or stable ID. Sharing never changes any score. Tier 2 (off by default) sends full signed receipts. Each receipt shares the payment's chain and transaction ID (no amount or wallet field); a transaction ID is public on-chain and can be linked to the paying wallet. Contributors get a public badge only, nothing of monetary value. See the kit README.

Configuration (environment)

VariableDefaultMeaning
EVM_PRIVATE_KEY–0x private key of your Base wallet that pays in USDC via an EIP-3009 authorization (gasless: the facilitator pays gas). Kept in memory only; never logged, returned to the model or sent anywhere (only the signature is sent). Use a dedicated low-balance agent wallet.
XRPL_SEED–Seed of your XRPL wallet that pays. Kept in memory only; never logged, returned to the model or sent anywhere (payments are signed locally, the API only receives the signed blob). Use a dedicated low-balance agent wallet.
LUMI_PAY_ASSETXRP if XRPL_SEED is set, else BASE_USDCBASE_USDC (USDC on Base), or XRP, RLUSD, USDC on the XRP Ledger (XRPL stablecoins need a trust line + balance)
LUMI_MAX_XRP_PER_CALL0.25Refuse any XRP quote above this
LUMI_MAX_USD_PER_CALL0.30Refuse any stablecoin quote (Base or XRPL) above this. The refusal message names this variable and the value needed
LUMI_SESSION_BUDGET1Max total spend per server process, in the pay asset
XRPL_NETWORKxrpl:0xrpl:0 mainnet, xrpl:1 testnet
LUMI_API_URLhttps://api.lumitrades.ioAPI base URL
LUMI_EXPECTED_PAY_TOLumi's wallets on the official API: rM8kmmnz5qPMg7V3r7SHYXgDGvm8PhzLvM (XRPL mainnet), 0x5E617bac19912e6d212CB303ae84655E9E203532 (Base)Refuse to pay any other address
LUMI_CHECK_APILUMI_API_URLBase URL for lumi_check
LUMI_KIT_HOME / LUMI_KIT_CONFIG~/.lumi-scanner-kit/config.jsonKit config (saved sharing answer, telemetry and sharing switches)
LUMI_CHECK_TELEMETRYoff (until the user says yes)on enables tier 1 outcome reports, off disables them; overrides the saved answer
LUMI_SHARE_RECEIPTSoff1 enables tier 2 receipt submission
LUMI_CONTRIB_KEY_FILE–Contributor key for tier 2 submissions (lumi-scan keygen)
XRPL_WS_URLwss://xrplcluster.com / wss://testnet.xrpl-labs.comLedger connection used to autofill and sign

Safety: before signing, the server checks network, scheme, asset, payee, per-call cap and session budget. Anything off and it does not sign. Every paid result carries the on-chain transaction hash.

Tests

npm test                         # spend-cap / payee / settings unit tests + a mocked Base USDC payment through @x402/fetch

node scripts-e2e-testnet.mjs # testnet only: real x402 payments through MCP against a local testnet API (see the file header)

License

MIT