Skip to content
MCP server

Lumi Verdict: check an x402 seller before paying

Check an x402 seller before your agent pays it, with signed test-buy evidence

Runs locally
Install
Pricing
Freemium
Platforms
CLI, API
Runs
Locally
Version
0.1.0
Listing updated
4 days ago

Similar MCP servers

About 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. It runs locally on your machine and is started by your AI client.

x402 lets an agent pay for an API call on the spot, which is risky when the seller is unknown. Lumi answers with an allow, warn or block result plus coded reasons, built from an index of Coinbase's x402 Bazaar, free checks of the seller's 402 quote and Lumi's own paid test-buys. Where Lumi has bought from a seller, the answer carries signed receipts that anyone can verify for free.

The stdio package signs payments locally from your wallet: an EVM key for USDC on Base, or an XRPL seed for XRP, RLUSD or USDC. Spending is capped by default at $0.30 per call for stablecoins, 0.25 XRP per call and $1 per server session, all adjustable through environment variables. XRPL mainnet is the default network, and a testnet option exists.

As of 14 November 2026 the vendor trust list covered 165,607 x402 listings across 6,824 seller domains, with 2,407 paid test-buys on record. Lumi describes its output as dated observations, not a rating or guarantee, and says paying never changes a score.

Install

Run in a terminal

claude mcp add lumi-verdict-mcp --env EVM_PRIVATE_KEY='<EVM_PRIVATE_KEY>' --env XRPL_SEED='<XRPL_SEED>' -- npx -y lumi-verdict-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "lumi-verdict-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "lumi-verdict-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>",
        "XRPL_SEED": "<XRPL_SEED>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "lumi-verdict-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "lumi-verdict-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>",
        "XRPL_SEED": "<XRPL_SEED>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "lumi-verdict-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "lumi-verdict-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>",
        "XRPL_SEED": "<XRPL_SEED>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "lumi-verdict-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "lumi-verdict-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>",
        "XRPL_SEED": "<XRPL_SEED>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "lumi-verdict-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "lumi-verdict-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>",
        "XRPL_SEED": "<XRPL_SEED>"
      }
    }
  }
}

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: BASE_USDC if only EVM_PRIVATE_KEY is set, else XRP
  • 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

What it does

Pre-payment verdict
Returns allow, warn or block with coded reasons for any x402 URL.
Signed test-buy receipts
Shows dated purchases with transaction hashes that can be verified for free.
Multi-chain payment
Pays in USDC on Base or Stellar, or XRP, RLUSD and USDC on the XRP Ledger.
Spend caps
Per-call and per-session limits are set through environment variables.
Batch checks
Checks up to 10 sellers in one signed answer.
Free trust list
The vendor list and seller lookup cost nothing.

Good for

  • Screen an unfamiliar x402 endpoint before paying it
  • Add a trust gate to an agent that buys data on its own
  • Read a seller's test-buy history before choosing between providers
  • Verify a signed receipt from a past purchase

Pricing

Freemium

Free pay check (100 a day) and trust list; other calls $0.005 to $0.02 via x402

Prices change. Check lumitrades.io before you buy.

Lumi Verdict: check an x402 seller before paying FAQ

Do I need an account or API key?

No. Paid calls are settled per request with x402, and new Base and XRPL wallets get 3 free calls in total.

How much does a check cost?

The pay check is free for 100 checks a day; other calls range from $0.005 to $0.02.

Which wallets does the server need?

An EVM private key for Base USDC, an XRPL seed, or both. Both are signed locally.

Does paying change a seller's score?

Lumi says paying never changes a score or label.

Is Lumi Verdict: check an x402 seller before paying free?

Lumi Verdict: check an x402 seller before paying has a free plan, with paid plans for more usage or features.

How do I add Lumi Verdict: check an x402 seller before paying to Claude Code?

Run this command in your terminal: claude mcp add lumi-verdict-mcp --env EVM_PRIVATE_KEY='<EVM_PRIVATE_KEY>' --env XRPL_SEED='<XRPL_SEED>' -- npx -y lumi-verdict-mcp

What are the best alternatives to Lumi Verdict: check an x402 seller before paying?

The closest alternatives to Lumi Verdict: check an x402 seller before paying are Lumi Trades: x402 seller checks and test-buys, x402 agent toolkit: service finder, payment safety, Solana & web tools, Lumière PayCheck, vet402-check and paidfor.

Where this comes from

  • Description: written from the project's README and the project's website.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers