Lumière PayCheck MCP
Lumière PayCheck monitors x402 endpoints to grade trust, check for hijacks, and provide verdicts before AI agents make payments. It allows agents to verify if an endpoint works, if the price is right, and if the payout wallet is legitimate, supporting features like spending rules, agent identity, and audit trails.
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.
MCP endpoint (Streamable HTTP)
https://lumierepaycheck.org/mcp?plans=1What its tools do
6 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Can change data (1)
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Check x402 endpoint trust grade before payment
- Verify payout wallet legitimacy
- Enforce spending rules for AI agents
- Monitor endpoint uptime and response time
Source and maintenance
Community listingRegistry 1.8.1
- Maintenance checked
Protocol and capabilities
- Server
- lumiere-paycheck 1.8.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 6 advertised
- Resources
- 2 advertised
- Resource templates
- 0 advertised
- Prompts
- 3 advertised
Server-advertised capabilities
{
"tools": {
"listChanged": true
},
"prompts": {
"listChanged": true
},
"resources": {
"listChanged": true
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
6 advertised
check_endpoint — Check an x402 endpoint
Advertised read-only
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
check_endpoint input schema
{
"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_endpoint output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url",
"monitored",
"verdict"
],
"properties": {
"url": {
"type": "string",
"description": "The endpoint checked"
},
"auth": {
"type": "object",
"required": [
"required",
"note"
],
"properties": {
"note": {
"type": "string"
},
"required": {
"type": "boolean",
"description": "true: the seller needs its own sign-in (account, API key or wallet signature) on top of x402"
}
},
"description": "Present when our paid test was refused for want of the seller's own sign-in (no money was taken). Have access? Send hasAccess: true to check_payment.",
"additionalProperties": false
},
"page": {
"type": "string",
"description": "Public page with the full history"
},
"grade": {
"type": "string",
"description": "A delivered cleanly; B delivered with a caveat; C unconfirmed; D doesn't work as listed, no money lost; F costs money or unsafe; ? with too little data"
},
"score": {
"type": [
"number",
"null"
],
"description": "0-100; null for free resources"
},
"advice": {
"type": "string",
"description": "What the verdict means for paying it, naming the actual cause"
},
"buyers": {
"type": "object",
"required": [
"reviewed"
],
"properties": {
"flags": {
"type": "array",
"items": {
"type": "string"
},
"description": "coordinated_wallets, self_funded, concentrated_buyers, shared_operator, estimated, partial_lookup"
},
"reviewed": {
"type": "boolean",
"description": "false until the seller's buyers have been reviewed (the biggest sellers are reviewed daily)"
},
"estimated": {
"type": "boolean",
"description": "true when counted from a sample of buyers"
},
"organicShare": {
"type": "number",
"description": "0-1: share of 30-day volume from independent buyers"
},
"buyerWallets30d": {
"type": "number",
"description": "Buyer wallets that paid the seller in 30 days"
},
"independentBuyers30d": {
"type": "number",
"description": "Independent buyers behind the seller's buyer wallets in 30 days (wallets funded from one source count as one)"
}
},
"description": "Who is really behind the seller's buyers. Never changes the grade.",
"additionalProperties": false
},
"points": {
"type": "object",
"required": [
"uptime",
"speed",
"stability",
"delivery",
"total"
],
"properties": {
"speed": {
"type": "string"
},
"total": {
"type": "string"
},
"uptime": {
"type": "string"
},
"delivery": {
"type": "string"
},
"stability": {
"type": "string"
}
},
"description": "The points behind the score: uptime /40, speed /15, stability /25, delivery /20",
"additionalProperties": false
},
"probes": {
"type": "number",
"description": "Checks counted in the last 7 days"
},
"values": {
"type": "object",
"required": [
"checked"
],
"properties": {
"checked": {
"type": "boolean",
"description": "true: automatic value checks passed on the latest paid test"
},
"warning": {
"type": "string",
"description": "A value that looks wrong (wrong subject, stale data, price far from the public spot price)"
}
},
"description": "Automatic value checks on the latest paid response. A warning caps the grade at B, never avoid.",
"additionalProperties": false
},
"browser": {
"type": "object",
"required": [
"ready",
"checkedAt"
],
"properties": {
"ready": {
"type": "boolean"
},
"problems": {
"type": "array",
"items": {
"type": "string"
}
},
"checkedAt": {
"type": "string"
}
},
"description": "Whether a browser-based agent can pay this endpoint (CORS on the 402 and the payment preflight). Server-side agents aren't affected. Never changes the grade.",
"additionalProperties": false
},
"listing": {
"type": "object",
"required": [
"matchesExample",
"warning",
"sellerFix"
],
"properties": {
"capped": {
"type": "boolean",
"description": "true: the data is reshaped vs the listing (nested, list vs item), grade capped at B; false: a minor gap, warning only"
},
"warning": {
"type": "string",
"description": "How the real response differs, and where to read the fields"
},
"sellerFix": {
"type": "string",
"description": "What the seller can change"
},
"matchesExample": {
"type": "boolean",
"description": "false: the paid response differs from the seller's own example"
}
},
"description": "Present only when the latest paid response differs from the listing's example or schema. The data is delivered.",
"additionalProperties": false
},
"reasons": {
"type": "array",
"items": {
"type": "object",
"required": [
"factor",
"effect",
"text"
],
"properties": {
"at": {
"type": "string",
"description": "Date of the event it's based on (YYYY-MM-DD)"
},
"text": {
"type": "string",
"description": "What we found, in plain words (paid-test results include the date and what came back)"
},
"limit": {
"type": "string",
"description": "The ceiling this factor puts on the grade, e.g. \"F (max 39)\""
},
"effect": {
"type": "string",
"description": "positive, neutral or negative"
},
"factor": {
"type": "string",
"description": "data, delivery, uptime, speed, wallet, price, listing, values, access or withdrawn"
}
},
"additionalProperties": false
},
"description": "Every factor behind the grade, most important first: paid tests (with date and what came back), uptime, speed, payout wallet, price, listing"
},
"verdict": {
"type": "string",
"description": "proceed | caution | avoid | free | insufficient_data"
},
"delivery": {
"type": "string",
"description": "verified = a real test payment was delivered; failing (see advice: an error after payment that didn't collect the money is D/caution; taking the money and failing is F/avoid); or unverified"
},
"forTeams": {
"type": "object",
"required": [
"message",
"plans",
"url",
"enterprise"
],
"properties": {
"url": {
"type": "string",
"description": "Plans and checkout"
},
"plans": {
"type": "string"
},
"freeKey": {
"type": "string"
},
"message": {
"type": "string"
},
"enterprise": {
"type": "string",
"description": "Private enterprise inquiry form"
}
},
"description": "Short note about team plans (per-agent keys, spend limits, audit trail)",
"additionalProperties": false
},
"headline": {
"type": "string",
"description": "One sentence: the verdict and its main reason"
},
"decidedBy": {
"type": "string",
"description": "Which rule set the final score (e.g. a ceiling from a failed paid test), or that it came straight from the points"
},
"lookalike": {
"type": "object",
"required": [
"of",
"reason"
],
"properties": {
"of": {
"type": "string"
},
"reason": {
"type": "string"
}
},
"description": "Present when this new endpoint looks like an imitation of an established seller (name one character off, lookalike characters, or a copied listing) and pays a different wallet. check_payment asks for review unless allowLookalike is true.",
"additionalProperties": false
},
"monitored": {
"type": "boolean",
"description": "false if the endpoint isn't in the monitored catalog"
},
"payToMode": {
"type": "string",
"description": "fixed, or per_request when the seller issues a new payout address per request"
},
"uptimePct": {
"type": "number",
"description": "Share of checks in the last 7 days that returned a valid payment quote"
},
"withdrawn": {
"type": "object",
"required": [
"at",
"reason",
"note"
],
"properties": {
"at": {
"type": "string"
},
"note": {
"type": "string"
},
"reason": {
"type": "string"
}
},
"description": "Present when the endpoint was withdrawn by its seller or is gone from the Bazaar: no longer for sale, don't pay it.",
"additionalProperties": false
},
"testedWith": {
"type": "object",
"required": [
"how",
"note"
],
"properties": {
"how": {
"type": "string"
},
"note": {
"type": "string"
}
},
"description": "Present when the latest passing paid test needed a sign-in or extra input: a seller-provided test account, a wallet sign-in, or the seller's declared test request.",
"additionalProperties": false
},
"x402Version": {
"type": "number",
"description": "x402 protocol version the endpoint quotes (1 or 2)"
},
"buyerReports": {
"type": "object",
"required": [
"confirmed",
"problems",
"ourTestQueued",
"windowDays",
"note"
],
"properties": {
"note": {
"type": "string"
},
"problems": {
"type": "number",
"description": "Buyers who reported a problem in 7 days"
},
"confirmed": {
"type": "number",
"description": "Buyers (customers or wallets) who reported a usable response in 7 days"
},
"windowDays": {
"type": "number"
},
"ourTestQueued": {
"type": "boolean",
"description": "Our own paid test is queued for this endpoint"
}
},
"description": "What real buyers reported after paying. Never changes the grade; confirmations move the endpoint up our paid-test queue.",
"additionalProperties": false
},
"exampleInput": {
"type": "object",
"required": [
"found",
"note"
],
"properties": {
"note": {
"type": "string"
},
"found": {
"type": "boolean"
}
},
"description": "Present when the listing's own example input got 'not found' when we paid (no money taken): use real input.",
"additionalProperties": false
},
"requiredInput": {
"type": "object",
"required": [
"documented",
"note"
],
"properties": {
"note": {
"type": "string"
},
"documented": {
"type": "boolean"
}
},
"description": "Present when our paid test was refused for want of a header or input the listing doesn't document (no money taken).",
"additionalProperties": false
},
"valuesChecked": {
"type": "boolean",
"description": "Latest paid check also passed known-answer value tests"
},
"walletIncidents": {
"type": "number",
"description": "Unexplained payout-wallet changes"
},
"walletUnconfirmed": {
"type": "number",
"description": "Recent wallet changes nobody could confirm yet"
}
},
"additionalProperties": false
}check_endpoint annotations
{
"title": "Check an x402 endpoint",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}check_payment — Check an x402 payment before paying
Advertised read-only
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
check_payment input schema
{
"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"
},
"asset": {
"type": "string",
"description": "Token (asset) address from the quote. Send it: a quote asking for a different token than this endpoint charges is denied (asset swap)."
},
"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. Send it: a quote on a network this endpoint never uses is denied."
},
"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)"
},
"allowLookalike": {
"type": "boolean",
"description": "true = don't ask for review when the endpoint is flagged as a possible lookalike of an established seller (default false)"
},
"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)"
}
}
}check_payment output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"allow",
"reasons",
"monitored"
],
"properties": {
"url": {
"type": "string"
},
"allow": {
"type": "boolean",
"description": "Pay only when true"
},
"grade": {
"type": "string"
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"score": {
"type": [
"number",
"null"
]
},
"buyers": {
"type": "object",
"required": [
"reviewed"
],
"properties": {
"flags": {
"type": "array",
"items": {
"type": "string"
},
"description": "coordinated_wallets, self_funded, concentrated_buyers, shared_operator, estimated, partial_lookup"
},
"reviewed": {
"type": "boolean",
"description": "false until the seller's buyers have been reviewed (the biggest sellers are reviewed daily)"
},
"estimated": {
"type": "boolean",
"description": "true when counted from a sample of buyers"
},
"organicShare": {
"type": "number",
"description": "0-1: share of 30-day volume from independent buyers"
},
"buyerWallets30d": {
"type": "number",
"description": "Buyer wallets that paid the seller in 30 days"
},
"independentBuyers30d": {
"type": "number",
"description": "Independent buyers behind the seller's buyer wallets in 30 days (wallets funded from one source count as one)"
}
},
"description": "Who is really behind the seller's buyers. Never changes the grade.",
"additionalProperties": false
},
"values": {
"type": "object",
"required": [
"checked"
],
"properties": {
"checked": {
"type": "boolean"
},
"warning": {
"type": "string"
}
},
"description": "Automatic value checks on the latest paid response",
"additionalProperties": false
},
"listing": {
"type": "object",
"required": [
"matchesExample",
"warning",
"sellerFix"
],
"properties": {
"capped": {
"type": "boolean",
"description": "true: the data is reshaped vs the listing (nested, list vs item), grade capped at B; false: a minor gap, warning only"
},
"warning": {
"type": "string",
"description": "How the real response differs, and where to read the fields"
},
"sellerFix": {
"type": "string",
"description": "What the seller can change"
},
"matchesExample": {
"type": "boolean",
"description": "false: the paid response differs from the seller's own example"
}
},
"description": "Present only when the latest paid response differs from the listing's example or schema. The data is delivered.",
"additionalProperties": false
},
"reasons": {
"type": "array",
"items": {
"type": "string"
},
"description": "Why it was allowed or denied"
},
"verdict": {
"type": [
"string",
"null"
],
"description": "proceed | caution | avoid | free | insufficient_data"
},
"delivery": {
"type": "string"
},
"forTeams": {
"type": "object",
"required": [
"message",
"plans",
"url",
"enterprise"
],
"properties": {
"url": {
"type": "string",
"description": "Plans and checkout"
},
"plans": {
"type": "string"
},
"freeKey": {
"type": "string"
},
"message": {
"type": "string"
},
"enterprise": {
"type": "string",
"description": "Private enterprise inquiry form"
}
},
"description": "Short note about team plans (per-agent keys, spend limits, audit trail)",
"additionalProperties": false
},
"observed": {
"anyOf": [
{
"type": "object",
"properties": {
"payTo": {
"type": [
"string",
"null"
]
},
"amount": {
"type": [
"string",
"null"
]
},
"assets": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tokens this endpoint has been seen quoting"
},
"seenAt": {
"type": [
"string",
"null"
]
},
"network": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The latest payment quote our monitor saw"
},
"lookalike": {
"type": "object",
"required": [
"of",
"reason"
],
"properties": {
"of": {
"type": "string"
},
"reason": {
"type": "string"
}
},
"description": "Present when this new endpoint looks like an imitation of an established seller (name one character off, lookalike characters, or a copied listing) and pays a different wallet. check_payment asks for review unless allowLookalike is true.",
"additionalProperties": false
},
"monitored": {
"type": "boolean",
"description": "Whether the endpoint is in the monitored catalog"
},
"payToMode": {
"type": "string"
},
"reviewable": {
"type": "boolean",
"description": "Denied only for reasons a person may approve"
},
"afterPaying": {
"type": "string",
"description": "How to report the outcome after paying (free, verified on-chain)"
},
"authRequired": {
"type": "boolean",
"description": "true: the seller needs its own sign-in on top of x402; send hasAccess: true if you have it"
},
"buyerReports": {
"type": "object",
"required": [
"confirmed",
"problems",
"ourTestQueued",
"windowDays",
"note"
],
"properties": {
"note": {
"type": "string"
},
"problems": {
"type": "number",
"description": "Buyers who reported a problem in 7 days"
},
"confirmed": {
"type": "number",
"description": "Buyers (customers or wallets) who reported a usable response in 7 days"
},
"windowDays": {
"type": "number"
},
"ourTestQueued": {
"type": "boolean",
"description": "Our own paid test is queued for this endpoint"
}
},
"description": "What real buyers reported after paying. Never changes the grade; confirmations move the endpoint up our paid-test queue.",
"additionalProperties": false
},
"gradeReasons": {
"type": "array",
"items": {
"type": "object",
"required": [
"factor",
"effect",
"text"
],
"properties": {
"at": {
"type": "string",
"description": "Date of the event it's based on (YYYY-MM-DD)"
},
"text": {
"type": "string",
"description": "What we found, in plain words (paid-test results include the date and what came back)"
},
"limit": {
"type": "string",
"description": "The ceiling this factor puts on the grade, e.g. \"F (max 39)\""
},
"effect": {
"type": "string",
"description": "positive, neutral or negative"
},
"factor": {
"type": "string",
"description": "data, delivery, uptime, speed, wallet, price, listing, values, access or withdrawn"
}
},
"additionalProperties": false
},
"description": "Every factor behind the endpoint's grade (same as check_endpoint's reasons)"
},
"declaredPayTo": {
"type": "array",
"items": {
"type": "string"
},
"description": "Payout wallets the seller declared itself"
},
"gradeHeadline": {
"type": "string",
"description": "Why the endpoint has its grade, in one sentence"
},
"walletUnconfirmed": {
"type": "number"
}
},
"additionalProperties": false
}check_payment annotations
{
"title": "Check an x402 payment before paying",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}report_outcome — Report how a paid x402 call went
Open-world
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.
report_outcome input schema
{
"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"
}
}
}report_outcome output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"accepted"
],
"properties": {
"url": {
"type": "string"
},
"paid": {
"type": "string",
"description": "Amount paid on-chain, atomic units"
},
"reason": {
"type": "string",
"description": "Why it wasn't accepted"
},
"thanks": {
"type": "string"
},
"flagged": {
"type": "string",
"description": "no_response, overcharged or double_charged: sent privately to the operator for an immediate re-test"
},
"network": {
"type": "string"
},
"outcome": {
"type": "string"
},
"accepted": {
"type": "boolean",
"description": "Whether the report was recorded"
},
"forTeams": {
"type": "object",
"required": [
"message",
"plans",
"url",
"enterprise"
],
"properties": {
"url": {
"type": "string",
"description": "Plans and checkout"
},
"plans": {
"type": "string"
},
"freeKey": {
"type": "string"
},
"message": {
"type": "string"
},
"enterprise": {
"type": "string",
"description": "Private enterprise inquiry form"
}
},
"description": "Short note about team plans (per-agent keys, spend limits, audit trail)",
"additionalProperties": false
},
"overcharge": {
"type": "string",
"description": "Present when the on-chain payment was higher than any quote we saw"
},
"retestQueued": {
"type": "boolean",
"description": "A paid re-test was queued because of reports"
},
"ourTestQueued": {
"type": "boolean",
"description": "Our own paid test of this endpoint is queued (buyer confirmations or problem reports moved it up)"
},
"verifiedOnChain": {
"type": "boolean",
"description": "The payment was found on-chain (reports sent with tx instead of a receipt)"
}
},
"additionalProperties": false
}report_outcome annotations
{
"title": "Report how a paid x402 call went",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}top_endpoints — Most trustworthy x402 endpoints
Advertised read-only
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).
top_endpoints input schema
{
"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)"
}
}
}top_endpoints output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"count",
"endpoints"
],
"properties": {
"count": {
"type": "number"
},
"forTeams": {
"type": "object",
"required": [
"message",
"plans",
"url",
"enterprise"
],
"properties": {
"url": {
"type": "string",
"description": "Plans and checkout"
},
"plans": {
"type": "string"
},
"freeKey": {
"type": "string"
},
"message": {
"type": "string"
},
"enterprise": {
"type": "string",
"description": "Private enterprise inquiry form"
}
},
"description": "Short note about team plans (per-agent keys, spend limits, audit trail)",
"additionalProperties": false
},
"endpoints": {
"type": "array",
"items": {
"type": "object",
"required": [
"url",
"score",
"grade",
"verdict",
"delivery"
],
"properties": {
"url": {
"type": "string"
},
"grade": {
"type": "string"
},
"score": {
"type": [
"number",
"null"
]
},
"verdict": {
"type": "string",
"description": "proceed | caution | avoid | free | insufficient_data"
},
"delivery": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Best first"
}
},
"additionalProperties": false
}top_endpoints annotations
{
"title": "Most trustworthy x402 endpoints",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}catalog_stats — x402 catalog statistics
Advertised 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.
catalog_stats input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}catalog_stats output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"scoredAt",
"endpoints",
"byVerdict"
],
"properties": {
"forTeams": {
"type": "object",
"required": [
"message",
"plans",
"url",
"enterprise"
],
"properties": {
"url": {
"type": "string",
"description": "Plans and checkout"
},
"plans": {
"type": "string"
},
"freeKey": {
"type": "string"
},
"message": {
"type": "string"
},
"enterprise": {
"type": "string",
"description": "Private enterprise inquiry form"
}
},
"description": "Short note about team plans (per-agent keys, spend limits, audit trail)",
"additionalProperties": false
},
"scoredAt": {
"type": [
"string",
"null"
],
"description": "When scores were last computed"
},
"byVerdict": {
"type": "object",
"description": "Endpoint count per verdict",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
},
"endpoints": {
"type": "number",
"description": "Endpoints monitored"
}
},
"additionalProperties": false
}catalog_stats annotations
{
"title": "x402 catalog statistics",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_full_report — How to get a full trust report
Advertised read-only
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
get_full_report input schema
{
"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"
}
}
}get_full_report output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"note": {
"type": "string"
},
"price": {
"type": "string"
},
"network": {
"type": "string"
},
"payment": {
"type": "string"
},
"forTeams": {
"type": "object",
"required": [
"message",
"plans",
"url",
"enterprise"
],
"properties": {
"url": {
"type": "string",
"description": "Plans and checkout"
},
"plans": {
"type": "string"
},
"freeKey": {
"type": "string"
},
"message": {
"type": "string"
},
"enterprise": {
"type": "string",
"description": "Private enterprise inquiry form"
}
},
"description": "Short note about team plans (per-agent keys, spend limits, audit trail)",
"additionalProperties": false
},
"available": {
"type": "boolean",
"description": "false when paid reports aren't enabled"
},
"reportUrl": {
"type": "string",
"description": "Request this URL with an x402 client to buy the report"
},
"otherPaidChecks": {
"type": "array",
"items": {
"type": "object",
"required": [
"what",
"request",
"price"
],
"properties": {
"what": {
"type": "string"
},
"price": {
"type": "string"
},
"request": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Other pay-per-call x402 checks, paid the same way"
}
},
"additionalProperties": false
}get_full_report annotations
{
"title": "How to get a full trust report",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
3 advertised
check_before_paying — Check an x402 endpoint before paying
Check an x402 endpoint's trust grade and, if you have its 402 quote, whether this specific payment should go through.
- url
- Full URL of the x402 endpoint, e.g. https://api.example.com/v1/data (required)
- amount
- Amount from the 402 quote in atomic units (USDC: 10000 = $0.01)
- payTo
- payTo wallet from the 402 quote
safe_endpoints — Find trustworthy x402 endpoints
List the x402 endpoints that are currently safest to pay, with their grades and whether a real test payment was delivered.
- topic
- Optional: what you need, e.g. 'crypto prices' or 'weather'
agent_payment_rule — Add a pay-safely rule to your agent
A standing instruction that makes your agent check every x402 payment with Lumière PayCheck first.
Resources
2 advertised
guide — How Lumière PayCheck works
What the verdicts and grades mean, how scores are made, and which tool to use when.
guide URI
paycheck://guidecatalog-stats — Catalog statistics
How many x402 endpoints are monitored right now and how many fall into each verdict.
catalog-stats URI
paycheck://stats30-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
- 2254 ms
- 95th percentile latency
- 2254 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 2254 ms · metadata changed · 6 tool(s), 2 resource(s), 0 resource template(s), 3 prompt(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http lumie-re-paycheck-mcp-lumierepaycheck https://lumierepaycheck.org/mcp?plans=1Codex
Codex configuration
codex mcp add lumie-re-paycheck-mcp-lumierepaycheck --url https://lumierepaycheck.org/mcp?plans=1Cursor
Cursor configuration
{
"mcpServers": {
"lumie-re-paycheck-mcp-lumierepaycheck": {
"url": "https://lumierepaycheck.org/mcp?plans=1"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"lumie-re-paycheck-mcp-lumierepaycheck": {
"type": "streamableHttp",
"url": "https://lumierepaycheck.org/mcp?plans=1",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"lumie-re-paycheck-mcp-lumierepaycheck": {
"type": "http",
"url": "https://lumierepaycheck.org/mcp?plans=1"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http lumie-re-paycheck-mcp-lumierepaycheck https://lumierepaycheck.org/mcp?plans=1Claude Desktop
Claude Desktop configuration
https://lumierepaycheck.org/mcp?plans=1Windsurf
Windsurf configuration
{
"mcpServers": {
"lumie-re-paycheck-mcp-lumierepaycheck": {
"serverUrl": "https://lumierepaycheck.org/mcp?plans=1"
}
}
}Let your agent find its tools
Find servers like Lumière PayCheck MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.