Lumière PayCheck

Working · 3.3 s

io.github.Book0fEli/paycheckv1.8.1

Check any x402 endpoint before your AI agent pays it: trust grade, verdict, and hijack checks.

Security Finance & Payments

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://lumierepaycheck.org/mcp?plans=1

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

catalog_stats Read-only

Get an overview of the whole monitored x402 catalog: how many endpoints are monitored, how many fall into each verdict (proceed, caution, avoid, free, insufficient_data), and when scores were last computed. Use it for context or reporting, for example to tell a user how much of the x402 ecosystem passes checks. It says nothing about any single endpoint: use check_endpoint for one endpoint, top_endpoints for a ranked list, or check_payment before paying. Read-only, free, no parameters.

This tool takes no arguments.

Tools (6)

catalog_stats

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

check_endpoint

Get the trust verdict for one x402 endpoint: score (0-100), grade (A-F), and verdict (proceed, caution, avoid, free, or insufficient_data), plus uptime, delivery-test status, payout-wallet incidents, and how many independent buyers stand behind the seller's buyer wallets (we count customers, not wallets). Use it when you're deciding whether an endpoint is trustworthy at all, before you have a price quote. When you already have the 402 quote (amount and payTo) and are about to pay, use check_payment instead: it runs this same check and also verifies the price and wallet. To discover good endpoints rather than check a known one, use top_endpoints. Read-only and free; reflects monitoring every 30 minutes and real test payments, so a brand-new endpoint may return insufficient_data. Endpoints not in the catalog return monitored: false. API docs: https://github.com/Book0fEli/lumiere-paycheck/blob/main/docs/api.md

read-only

Argument	Type	Description
url*	string	Full URL of the x402 endpoint including path, exactly as the agent will call it, e.g. https://api.example.com/v1/price.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Full URL of the x402 endpoint including path, exactly as the agent will call it, e.g. https://api.example.com/v1/price."
    }
  }
}

check_payment

Decide whether a specific x402 payment should go through: returns allow true/false with reasons. Checks the endpoint's trust verdict, that the amount is within your cap and not above the monitored price, and that the payTo wallet matches the one we've observed (catches swapped or hijacked wallets). Optionally (minOrganicShare) it also requires that enough of the seller's volume comes from independent buyers. Intended for right before a payment, with the amount, payTo, and network from the endpoint's 402 quote; allow is true only when every rule passes. Use check_endpoint instead if you only want an endpoint's grade without a quote in hand. Read-only and free; it doesn't make or block the payment itself. When allow is false, the reasons list explains why. API docs: https://github.com/Book0fEli/lumiere-paycheck/blob/main/docs/api.md

read-only

Argument	Type	Description
url*	string	Full URL of the x402 endpoint you are about to pay, including path
payTo	string	Wallet address from the endpoint's 402 quote
amount	string	Amount about to be paid, atomic units (USDC has 6 decimals: 10000 = $0.01)
network	string	Network from the quote, e.g. eip155:8453
hasAccess	boolean	true if you have your own account, API key or sign-in with this seller. For endpoints that need the seller's sign-in on top of x402, allowCaution/requireVerified then don't block (we couldn't confirm delivery only because we can't sign in).

get_full_report

Get instructions for buying the detailed paid report on one x402 endpoint (score breakdown, current price quote, wallet and price history, test-payment results). Returns the report URL, price, and network; it doesn't buy the report itself. The report is an x402 endpoint that your agent pays with any x402 client. Use it only when the free check_endpoint result isn't enough and the user wants the full history. The response also lists the other paid x402 checks (wallet risk, batch grades, watch alerts), paid the same way. Endpoints we don't monitor return 404 on the report URL and are never charged. API docs: https://github.com/Book0fEli/lumiere-paycheck/blob/main/docs/api.md

read-only

Argument	Type	Description
url*	string	Full URL of the x402 endpoint you want the paid report for, including path

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Full URL of the x402 endpoint you want the paid report for, including path"
    }
  }
}

report_outcome

After paying an x402 endpoint, report whether you got what you paid for. Free, optional, and open to every agent: send the receipt from a Lumière PayCheck allow decision (paid plans), or the endpoint url plus the payment's transaction hash (anyone; we verify the payment on-chain, Base or Solana, within 24 hours). Answer the short questions in answers: gotResponse, matchedListing (yes/partly/no), charged (as_quoted/more/twice), dataUsable (yes/unsure/no), wouldPayAgain. Reports never change a grade by themselves: confirmations from independent buyers move the endpoint up our paid-test queue, and serious problems (nothing came back, charged more or twice) trigger a re-test; only our own paid test changes the grade. One report per payment; the seller's own wallet can't report on itself.

Argument	Type	Description
tx	string	The payment's transaction hash (Base 0x...) or Solana signature
url	string	The endpoint you paid (with tx, when you have no receipt)
answers	object
outcome	string	Optional shortcut instead of answers: delivered = usable; problem = error, empty, wrong or overcharged
receipt	string	The receipt from a Lumière PayCheck 'allow' decision (paid plans). Or send url + tx instead.
problems	array	Short descriptions, e.g. 'missing field price', 'HTTP 500'
httpStatus

top_endpoints

List the x402 endpoints that are currently safest to pay (verdict proceed or caution, no payout-wallet incidents), best first, with score, grade, verdict, and whether a real test payment was delivered. Use it to discover reliable endpoints or pick between providers. To evaluate one specific endpoint use check_endpoint; to approve a payment use check_payment. Read-only and free; rankings update as monitoring runs (every 30 minutes).

read-only

Argument	Type	Description
limit	integer	How many endpoints to return, 1-50 (default 10)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "How many endpoints to return, 1-50 (default 10)"
    }
  }
}

{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "url" ], "properties": { "url": { "type": "string", "description": "Full URL of the x402 endpoint you are about to pay, including path" }, "payTo": { "type": "string", "description": "Wallet address from the endpoint's 402 quote" }, "amount": { "type": "string", "description": "Amount about to be paid, atomic units (USDC has 6 decimals: 10000 = $0.01)" }, "network": { "type": "string", "description": "Network from the quote, e.g. eip155:8453" }, "hasAccess": { "type": "boolean", "description": "true if you have your own account, API key or sign-in with this seller. For endpoints that need the seller's sign-in on top of x402, allowCaution/requireVerified then don't block (we couldn't confirm delivery only because we can't sign in)." }, "maxAmount": { "type": "string", "description": "Your hard cap for this payment in atomic units (USDC: 1000000 = $1). Payments above it are denied." }, "allowCaution": { "type": "boolean", "description": "false = deny endpoints with a caution verdict too, not just avoid (default true)" }, "priceTolerance": { "type": "number", "maximum": 0.5, "minimum": 0, "description": "Optional, 0-0.5 (default 0.02 = 2%): how far above the endpoint's recent prices still counts as the same price, for sellers whose price drifts (pegged to BTC, gas or FX). Bigger jumps are denied as overcharges." }, "minOrganicShare": { "type": "number", "maximum": 1, "minimum": 0, "description": "Optional, 0-1: deny sellers where less than this share of 30-day volume comes from independent buyers (e.g. 0.5). Not applied to sellers whose buyers haven't been reviewed yet." }, "requireVerified": { "type": "boolean", "description": "true = only allow endpoints that delivered on a real test payment (default false)" } } }

{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "tx": { "type": "string", "description": "The payment's transaction hash (Base 0x...) or Solana signature" }, "url": { "type": "string", "description": "The endpoint you paid (with tx, when you have no receipt)" }, "answers": { "type": "object", "properties": { "charged": { "enum": [ "as_quoted", "more", "twice" ], "type": "string", "description": "Were you charged the quoted amount, once?" }, "dataUsable": { "enum": [ "yes", "unsure", "no" ], "type": "string", "description": "Did the data look real and usable?" }, "gotResponse": { "type": "boolean", "description": "Did you get a response after paying?" }, "wouldPayAgain": { "type": "boolean", "description": "Would you pay this endpoint again?" }, "matchedListing": { "enum": [ "yes", "partly", "no" ], "type": "string", "description": "Did it match what the listing promised?" } } }, "outcome": { "enum": [ "delivered", "problem" ], "type": "string", "description": "Optional shortcut instead of answers: delivered = usable; problem = error, empty, wrong or overcharged" }, "receipt": { "type": "string", "description": "The receipt from a Lumière PayCheck 'allow' decision (paid plans). Or send url + tx instead." }, "problems": { "type": "array", "items": { "type": "string" }, "description": "Short descriptions, e.g. 'missing field price', 'HTTP 500'" }, "httpStatus": { "type": "integer", "maximum": 9007199254740991, "minimum": -9007199254740991, "description": "HTTP status the endpoint returned after payment, e.g. 200 or 500" } } }