# 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. Pre-payment trust checks and paid test-buys for x402 sellers, for AI agents and developers. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, CLI, Web
- **Website:** https://api.lumitrades.io/skill.md
- **Repository:** https://github.com/lumitrades/lumi-api/tree/HEAD/mcp
- **MCP Registry name:** io.github.cypher-osiris/lumi-trades-mcp
- **Categories:** [cloud and infrastructure](https://ai-powered.com/categories/cloud-and-infrastructure)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.lumitrades.io/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
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.

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

All 11 tools say they're read-only. From the server's own tool annotations; not verified by us.

- `lumi_trust_check` (says 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_check` (says 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_catalog` (says 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_samples` (says 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_quote` (says 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_scores` (says 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_verdict` (says 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_monitoring` (says 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_feed` (says 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_check` (says 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_report` (says 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 

## 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.

## Alternatives

- [Lumi Verdict: check an x402 seller before paying](https://ai-powered.com/mcp/lumi-verdict-check-an-x402-seller-before-paying): Lumi Verdict: check an x402 seller before paying is a freemium MCP server for finance and payments.
- [x402 endpoint checker](https://ai-powered.com/mcp/x402-endpoint-checker): x402 endpoint checker is a free MCP server for cloud and infrastructure.

---
Source: https://ai-powered.com/mcp/lumi-trades-x402-seller-checks-and-test-buys
