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.
https://api.lumitrades.io/mcpWhat 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
- 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
{
"tools": {
"listChanged": false
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
11 advertised
lumi_trust_check — Lumi: should I pay this x402 URL? (free, rate-limited)
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.
{
"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"
}
}
}{
"readOnlyHint": true,
"openWorldHint": true
}lumi_wallet_check — Lumi: which x402 sellers did this wallet pay? (free, rate-limited)
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.
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"maxLength": 120,
"description": "A public wallet address: Base 0x..., XRP Ledger r... or Stellar G..."
}
}
}{
"readOnlyHint": true,
"openWorldHint": true
}lumi_catalog — Lumi: endpoints and live prices (free)
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.
{
"type": "object",
"properties": {}
}{
"readOnlyHint": true,
"openWorldHint": true
}lumi_samples — Lumi: free samples of every paid product
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.
{
"type": "object",
"properties": {
"route": {
"type": "string",
"pattern": "^[a-z_]{1,32}$",
"description": "Optional product route, e.g. high_value_check or vendor_report"
}
}
}{
"readOnlyHint": true,
"openWorldHint": true
}lumi_quote — Lumi: price check without paying (free)
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.
{
"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"
}
}
}{
"readOnlyHint": true,
"openWorldHint": true
}lumi_vendor_scores — Lumi: x402 vendor observations (free)
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).
{
"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"
}
}
}{
"readOnlyHint": true,
"openWorldHint": true
}lumi_verdict — Lumi: one-label pre-payment check (paid)
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.
{
"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"
}
}
}{
"readOnlyHint": true,
"openWorldHint": true
}lumi_seller_monitoring — Lumi: seller monitoring plans and monitored sellers (free)
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.
{
"type": "object",
"properties": {
"enrollment_id": {
"type": "string",
"pattern": "^men_[a-f0-9]{24}$",
"description": "Optional enrollment id (men_...)"
}
}
}{
"readOnlyHint": true,
"openWorldHint": true
}lumi_trust_feed — Lumi: trust data feed plans and licence (free)
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).
{
"type": "object",
"properties": {}
}{
"readOnlyHint": true,
"openWorldHint": true
}lumi_high_value_check — Lumi: high value check (paid)
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).
{
"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)"
}
}
}{
"readOnlyHint": true,
"openWorldHint": true
}lumi_vendor_report — Lumi: vendor report (paid)
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.
{
"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"
}
}
}{
"readOnlyHint": true,
"openWorldHint": true
}Prompts
Not advertised
Resources
Not advertised
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.
Claude Code
claude mcp add --transport http lumi-trades-mcp-lumitrades https://api.lumitrades.io/mcpCodex
codex mcp add lumi-trades-mcp-lumitrades --url https://api.lumitrades.io/mcpCursor
{
"mcpServers": {
"lumi-trades-mcp-lumitrades": {
"url": "https://api.lumitrades.io/mcp"
}
}
}Cline
{
"mcpServers": {
"lumi-trades-mcp-lumitrades": {
"type": "streamableHttp",
"url": "https://api.lumitrades.io/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"lumi-trades-mcp-lumitrades": {
"type": "http",
"url": "https://api.lumitrades.io/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http lumi-trades-mcp-lumitrades https://api.lumitrades.io/mcpClaude Desktop
{
"mcpServers": {
"lumi-trades-mcp-lumitrades": {
"url": "https://api.lumitrades.io/mcp"
}
}
}Windsurf
{
"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.