Koskamo

Lumi Trades MCP

An MCP server for verifying x402 seller trust before payment. It provides free and paid seller checks, verdicts, vendor reports, and signed test-buy receipts on XRPL, Base, and Stellar to help agents decide whether to pay a vendor.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Lumi Trades MCP logo, by Lumi TradesCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-01Published by Lumi Trades
You need:New Base and XRPL wallets get 3 free calls in total, usable on any paid routesend X-Lumi-Trial: 1 and sign the 402's sign-in-with-x challenge with a Base wallet holding at least 0.01 USDC or an activated XRP Ledger accountNo API key, no account, no sign-up for the per-call endpoints
MCP endpoint (Streamable HTTP)
https://api.lumitrades.io/mcp
Vendor documentation

What you can do with it

  • Check if an x402 seller is safe to pay before making a transaction
  • Retrieve signed test-buy receipts to verify seller delivery history
  • Get vendor reports with observation history and latency stats
  • Perform batch checks on multiple x402 seller URLs

Source and maintenance

Community listingRegistry 0.9.9
Maintenance checked

Protocol and capabilities

Server
lumi-trades 1.2.0
MCP protocol
2025-06-18
Tools
11 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": false
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Lumi Trades (lumitrades.io): an x402 seller trust service. Start with lumi_trust_check (free, rate-limited): allow / warn / block with coded reasons before you pay an x402 seller. It returns the label (checks_passed / check_first / checks_failed / no_data) and an allow / warn / block verdict. Then, only if needed: lumi_verdict (paid, $0.01: the same one label, signed), lumi_high_value_check (paid, 0.5% of the amount, min $0.005, max $0.25: same verdict and score plus a live re-check and an amount-bound receipt), lumi_vendor_scores and lumi_vendor_report (paid, $0.02), lumi_seller_monitoring, lumi_trust_feed. Free: lumi_catalog, lumi_samples (truncated previews of every paid product), lumi_quote, lumi_trust_check (rate-limited), lumi_wallet_check (rate-limited: which x402 sellers a public wallet paid, with Lumi's facts on each), lumi_vendor_scores (Lumi's observations of other x402 vendors), lumi_seller_monitoring (plans, packs, free tier and 14-day trial) and lumi_trust_feed (free key, Feed and Feed Pro); lumi_vendor_report is the paid full history for one vendor. lumi_verdict is paid (on this remote server it returns the x402 terms; the free signed GET /v1/check has the same data). Paid tools are priced per call via x402 (live prices: lumi_catalog, lumi_quote); paid in XRP, RLUSD or USDC on the XRP Ledger or USDC on Base or Stellar; new wallets get 3 free trial calls over REST (x402 sign-in-with-x; nothing is charged or moved): a Base wallet holding at least 0.01 USDC or an activated XRP Ledger account, one trial per wallet; without access they return the price and how to pay. Paid tools on this remote server return the price and how to pay (x402 at the REST URL on XRPL, Base or Stellar, or the lumi-trades-mcp npm package with an XRPL or Base wallet); the owner key gets the data. Never charged when Lumi cannot answer. Automated observations, not an endorsement or guarantee. Cite 'Lumi Trades (lumitrades.io)'.

Tools

11 advertised

lumi_trust_check — Lumi: should I pay this x402 URL? (free, rate-limited)
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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 separately). Pass url, and optionally the payTo and USD amount you were quoted, to catch address or price mismatches. Links the free lookup and, for curated vendors, the paid full report. Observations, not a guarantee. Near the top of the result, paid_option names the paid high-value check (lumi_high_value_check; its price is in its own description), which returns the same verdict and score.

lumi_trust_check input schema
{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "maxLength": 500,
      "description": "The x402 resource URL you are about to pay"
    },
    "payTo": {
      "type": "string",
      "maxLength": 120,
      "description": "Optional: the payTo address in its 402 quote"
    },
    "amount": {
      "type": "string",
      "maxLength": 20,
      "description": "Optional: the quoted price in USD, e.g. 0.01"
    }
  }
}
lumi_trust_check annotations
{
  "readOnlyHint": true,
  "openWorldHint": true
}
lumi_wallet_check — Lumi: which x402 sellers did this wallet pay? (free, rate-limited)
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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 failed, repeat or possible duplicate payments). Base reads Lumi's index of public USDC transfers into CDP Bazaar payTos; XRPL and Stellar read the latest 200 ledger entries. Public data only; Lumi does not store the address. No price comparisons. Observations, not a guarantee.

lumi_wallet_check input schema
{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "maxLength": 120,
      "description": "A public wallet address: Base 0x..., XRP Ledger r... or Stellar G..."
    }
  }
}
lumi_wallet_check annotations
{
  "readOnlyHint": true,
  "openWorldHint": true
}
lumi_catalog — Lumi: endpoints and live prices (free)
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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_catalog input schema
{
  "type": "object",
  "properties": {}
}
lumi_catalog annotations
{
  "readOnlyHint": true,
  "openWorldHint": true
}
lumi_samples — Lumi: free samples of every paid product
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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_samples input schema
{
  "type": "object",
  "properties": {
    "route": {
      "type": "string",
      "pattern": "^[a-z_]{1,32}$",
      "description": "Optional product route, e.g. high_value_check or vendor_report"
    }
  }
}
lumi_samples annotations
{
  "readOnlyHint": true,
  "openWorldHint": true
}
lumi_quote — Lumi: price check without paying (free)
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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_quote input schema
{
  "type": "object",
  "required": [
    "path"
  ],
  "properties": {
    "path": {
      "type": "string",
      "pattern": "^/v1/",
      "description": "Paid API path, e.g. /v1/trust/check/high-value?url=...&amount=10 or /v1/trust/vendors/printmoneylab/report"
    }
  }
}
lumi_quote annotations
{
  "readOnlyHint": true,
  "openWorldHint": true
}
lumi_vendor_scores — Lumi: x402 vendor observations (free)
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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 'quote-checked, low confidence', plus Lumi's own test-buys confirmed on-chain, labelled 'test-bought' and counted per chain (Base USDC buys of Bazaar listings; XRPL buys of a small curated list, separately). Answer-only: the full coded verdict is in the free lumi_trust_check. Observations, not ratings; no match is not a negative finding. With no arguments: the curated XRPL vendor scores and catalog counts; vendor_id gives one curated vendor's summary (tx evidence is in the paid vendor report).

lumi_vendor_scores input schema
{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "maxLength": 500,
      "description": "Resource URL you are about to pay, e.g. https://example.com/api/data"
    },
    "payTo": {
      "type": "string",
      "maxLength": 120,
      "description": "payTo address from the seller's 402 quote (0x... or r...)"
    },
    "domain": {
      "type": "string",
      "maxLength": 253,
      "description": "Seller host or domain, e.g. example.com"
    },
    "vendor_id": {
      "type": "string",
      "pattern": "^[a-z0-9-]{1,64}$",
      "description": "Optional curated vendor id, e.g. printmoneylab"
    }
  }
}
lumi_vendor_scores annotations
{
  "readOnlyHint": true,
  "openWorldHint": true
}
lumi_verdict — Lumi: one-label pre-payment check (paid)
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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_data (Not enough data), with as-of date, evidence window, conclusive test-buy count, last delivered/failed dates, reason codes, evidence and appeal links, and observed on-chain payments as ranges only. Paying Lumi never changes a result. Observations, not a guarantee.

lumi_verdict input schema
{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "maxLength": 500,
      "description": "The x402 resource URL (or the seller's domain) you are about to pay"
    },
    "payTo": {
      "type": "string",
      "maxLength": 120,
      "description": "Optional: the payTo address in its 402 quote"
    },
    "amount": {
      "type": "string",
      "maxLength": 20,
      "description": "Optional: the quoted price in USD, e.g. 0.01"
    }
  }
}
lumi_verdict annotations
{
  "readOnlyHint": true,
  "openWorldHint": true
}
lumi_seller_monitoring — Lumi: seller monitoring plans and monitored sellers (free)
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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, findings, replies) and live badge status. Plans are paid over x402 at the REST URL.

lumi_seller_monitoring input schema
{
  "type": "object",
  "properties": {
    "enrollment_id": {
      "type": "string",
      "pattern": "^men_[a-f0-9]{24}$",
      "description": "Optional enrollment id (men_...)"
    }
  }
}
lumi_seller_monitoring annotations
{
  "readOnlyHint": true,
  "openWorldHint": true
}
lumi_trust_feed — Lumi: trust data feed plans and licence (free)
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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_trust_feed input schema
{
  "type": "object",
  "properties": {}
}
lumi_trust_feed annotations
{
  "readOnlyHint": true,
  "openWorldHint": true
}
lumi_high_value_check — Lumi: high value check (paid)
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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 (and optionally the payTo in its quote). The exact price for your amount is in the x402 quote (see lumi_quote).

lumi_high_value_check input schema
{
  "type": "object",
  "required": [
    "url",
    "amount"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "The x402 resource URL you are about to pay"
    },
    "payTo": {
      "type": "string",
      "description": "Optional: the payTo address in its 402 quote"
    },
    "amount": {
      "type": "string",
      "description": "The USD amount you are about to pay, e.g. 10 (sets the price of this check)"
    }
  }
}
lumi_high_value_check annotations
{
  "readOnlyHint": true,
  "openWorldHint": true
}
lumi_vendor_report — Lumi: vendor report (paid)
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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 call over x402 (USDC on Base, XRP / RLUSD / USDC on the XRP Ledger, or USDC on Stellar; the live quote is in lumi_quote). The free summary is lumi_vendor_scores.

lumi_vendor_report input schema
{
  "type": "object",
  "required": [
    "vendor_id"
  ],
  "properties": {
    "vendor_id": {
      "type": "string",
      "pattern": "^[a-z0-9-]{1,64}$",
      "description": "Vendor id from lumi_vendor_scores, e.g. printmoneylab"
    }
  }
}
lumi_vendor_report annotations
{
  "readOnlyHint": true,
  "openWorldHint": true
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
720 ms
95th percentile latency
720 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 720 ms · metadata changed · 11 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http lumi-trades-mcp-lumitrades https://api.lumitrades.io/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add lumi-trades-mcp-lumitrades --url https://api.lumitrades.io/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable lumi-trades-mcp-lumitrades in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "lumi-trades-mcp-lumitrades": {
      "url": "https://api.lumitrades.io/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "lumi-trades-mcp-lumitrades": {
      "type": "streamableHttp",
      "url": "https://api.lumitrades.io/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start lumi-trades-mcp-lumitrades and inspect its tools.
VS Code configuration
{
  "servers": {
    "lumi-trades-mcp-lumitrades": {
      "type": "http",
      "url": "https://api.lumitrades.io/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http lumi-trades-mcp-lumitrades https://api.lumitrades.io/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.
Claude Desktop configuration
{
  "mcpServers": {
    "lumi-trades-mcp-lumitrades": {
      "url": "https://api.lumitrades.io/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "lumi-trades-mcp-lumitrades": {
      "serverUrl": "https://api.lumitrades.io/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Lumi Trades MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.