Skip to content
MCP server

Lumi Trades: x402 seller checks and test-buys

Pre-payment trust checks and paid test-buys for x402 sellers, for AI agents and developers

Answered our latest tool-list check 7 hours ago with 11 tools. It will be marked verified after 3 successful checks in 7 days.

Install
Pricing
Open source
Platforms
API, CLI, Web
Runs
Locally or Remotely
Version
0.9.9
Listing updated
1 day ago

Similar MCP servers

About Lumi Trades: x402 seller checks and test-buys

Lumi Trades: x402 seller checks and test-buys is an open-source MCP server for cloud and infrastructure. It can run locally on your machine or as a hosted remote server.

The README describes this server as a way for agents to check an x402 seller before paying it. Its free check returns an allow, warn or block result with reason codes, and it is backed by Lumi's own paid test-buys on the XRP Ledger, Base and Stellar.

The package runs locally over stdio and pays paid tools per call from the user's own wallet, using USDC on Base or XRP, RLUSD or USDC on the XRP Ledger. Per-call and per-session spending caps are set through environment variables, and signing happens on the user's machine. The same tools are also offered as a remote Streamable HTTP server for clients that accept a URL.

It suits developers and agent builders who pay x402 endpoints and want a check on payee address, price and seller history before the payment goes out. Lumi describes its results as automated observations rather than ratings or guarantees.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://api.lumitrades.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "lumi-trades-mcp": {
      "url": "https://api.lumitrades.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to Grok Bot desktop app → Connect apps → Add a custom connector

https://api.lumitrades.io/mcp

Enter a Name (for example "Lumi Trades: x402 seller checks and test-buys"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

Full Grok Bot setup guide

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • EVM_PRIVATE_KEY0x private key of your Base wallet that pays in USDC (gasless, signed locally)
  • XRPL_SEEDSeed of your XRPL wallet that pays in XRP/RLUSD/USDC (signed locally)
  • LUMI_PAY_ASSETBASE_USDC, XRP, RLUSD or USDC (XRPL). Default: XRP if XRPL_SEED set, else BASE_USDC
  • LUMI_MAX_USD_PER_CALLPer-call cap in USD for stablecoins (covers every Lumi endpoint)
  • LUMI_MAX_XRP_PER_CALLPer-call cap in XRP
  • LUMI_SESSION_BUDGETMax total spend per server process
  • XRPL_NETWORKxrpl:0 mainnet or xrpl:1 testnet

Tools this server provides (11)

Read directly from the server.

All 11 tools say they're read-only.

From the server's own tool annotations; not verified by us.

lumi_trust_checkSays read-only
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 checks and Lumi's own test-buys (Base USDC for Bazaar listings; XRPL only for a small curated vendor list, counted separ
lumi_wallet_checkSays read-only
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 delivered, or that Lumi has not test-bought it yet) and simple flags (listing looks dead, no longer listed, recent checks f
lumi_catalogSays read-only
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_samplesSays read-only
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_quoteSays read-only
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_scoresSays read-only
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 schedule (valid quote, price and payTo vs the listing, latency, domain age; live coverage counts in the response), labelled
lumi_verdictSays read-only
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/check: checks_passed (Delivered in recent checks), check_first (Check first), checks_failed (Recent checks failed) or no_d
lumi_seller_monitoringSays read-only
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 changes a score. No args: plans, enrolment steps and safeguards. enrollment_id: that seller's public entry (disclosure, fin
lumi_trust_feedSays read-only
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, attribution).
lumi_high_value_checkSays read-only
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 at call time and a Lumi-signed receipt bound to the stated amount. Pass url and the USD amount you are about to pay (an
lumi_vendor_reportSays read-only
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, agent reports, vendor replies, sample sizes and confidence labels. Automated observations, not a rating. Paid: $0.02 per

What it does

Free pre-payment seller check
Returns allow, warn or block for an x402 URL, with coded reasons such as payTo mismatch or slow responses.
Paid test-buys as evidence
Seller results draw on Lumi's own small paid test-buys, each listed with a transaction hash.
Local wallet signing
Paid calls are signed on the user's machine with their own Base or XRP Ledger wallet.
Spend caps
Per-call and per-session limits are configurable and checked before any payment is signed.
Remote and local modes
Available as a local npm stdio server or as a hosted Streamable HTTP endpoint.

Good for

  • Check an x402 seller's payee address and price before an agent pays it
  • Look up a vendor's observation history before committing a larger payment
  • Add a pre-payment hook to an x402 client so payments to blocked sellers are aborted
  • Browse seller trust data from an MCP client without setting up a wallet

Pricing

Open source

Server is MIT licensed and free to run; paid Lumi API calls cost per request, from $0.01 to $0.02 for the tools named in the README.

Prices change. Check api.lumitrades.io before you buy.

Lumi Trades: x402 seller checks and test-buys FAQ

Do I need a wallet to use it?

Free tools work without one. Paid tools need a wallet key or seed set in the environment; without one they return the price and how to pay.

Which payment methods does the local server support?

The README says it pays with USDC on Base, or with XRP, RLUSD or USDC on the XRP Ledger. The API also accepts USDC on Stellar, but this package does not pay on Stellar.

What happens if Lumi cannot be reached during a check?

By default the check fails open and returns warn within 2.5 seconds, so payment proceeds. The README says failMode can be set to closed to block instead.

Are the scores ratings?

No. The README states that Lumi's results are automated observations, not a rating, endorsement or guarantee.

Is Lumi Trades: x402 seller checks and test-buys free?

Yes. Lumi Trades: x402 seller checks and test-buys is open source, so you can use and self-host it for free.

How do I add Lumi Trades: x402 seller checks and test-buys to Claude Code?

Run this command in your terminal: claude mcp add --transport http lumi-trades-mcp https://api.lumitrades.io/mcp

What are the best alternatives to Lumi Trades: x402 seller checks and test-buys?

The closest alternatives to Lumi Trades: x402 seller checks and test-buys are Lumi Verdict: check an x402 seller before paying and x402 endpoint checker.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Status and tools: checked automatically by AIPoweredBot on 19 November 2026.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers