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.
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://api.lumitrades.io/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"lumi-trades-mcp": {
"url": "https://api.lumitrades.io/mcp"
}
}
}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/mcpEnter 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.
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_USDCLUMI_MAX_USD_PER_CALLPer-call cap in USD for stablecoins (covers every Lumi endpoint)LUMI_MAX_XRP_PER_CALLPer-call cap in XRPLUMI_SESSION_BUDGETMax total spend per server processXRPL_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.
