x402-list-mcp

endpoint

https://mcp.x402-list.com/mcp

protocol

http-sse ·2025-06-18

authentication

none observed

public key

none — nobody has proven they own this listing · is it yours? claim it

karma

0 · newcomer

Is x402-list-mcp live?

Yes — it answered the hub's last check (checked 1h ago). It answered 100% of checks over the last 30 days.

Is x402-list-mcp free to use?

Yes — the hub reached it with no key and no payment.

What tools does x402-list-mcp have?

7 tools: x402_assess_services, x402_get_service, x402_change_events, x402_facilitator_volumes, x402_find_best_service, x402_search_services, x402_check_health.

Is x402-list-mcp safe to connect?

The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

• x402_change_events reads open 7h ago

  Call this before you trust anything you cached about a service, and right after a payment failed for no obvious reason: the monitor's log of what moved under you. Returns payTo, price and 402-schema changes observed on listed services, most recent first, in exactly three event types (payto_changed, price_changed, schema_changed). Filter with service (the slug), type, and days (1 to 365, default 90). Caveats: prices here are atomic token amounts, never dollars, and every payTo is masked by design, so the feed reports THAT the payout address changed, never the address. Free and read-only.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "properties": {
      "days": {
        "type": "integer",
        "default": 90,
        "maximum": 365,
        "minimum": 1,
        "description": "Lookback window in days, 1 to 365 (default 90). Events older than the window are not in the feed."
      },
      "page": {
        "type": "integer",
        "default": 1,
        "minimum": 1,
        "description": "1-based page index into the filtered event set (see total_pages)."
      },
      "type": {
        "enum": [
          "payto_changed",
          "price_changed",
          "schema_changed"
        ],
        "type": "string",
        "description": "Restrict to one kind of change: 'payto_changed' (the payout address set changed), 'price_changed' (at least one endpoint's price changed), 'schema_changed' (the 402 envelope gained or lost accepts entries or priced endpoints). Omit for all three."
      },
      "service": {
        "type": "string",
        "maxLength": 200,
        "minLength": 1,
        "description": "Service slug to restrict the feed to, e.g. 'exa' (the same slug x402_get_service takes). Omit for changes across every listed service."
      },
      "per_page": {
        "type": "integer",
        "default": 25,
        "maximum": 100,
        "minimum": 1,
        "description": "Events per page, 1 to 100 (default 25). Each event carries the full before/after envelope snapshots, so a large page is heavy."
      }
    },
    "additionalProperties": false
  }

  arguments 42 lines copy
• x402_facilitator_volumes reads open 7h ago

  Call this when the question is about the rail rather than the service: which x402 facilitator actually settles money, and how much. Returns on-chain-verified settlement volume and transaction counts per facilitator for today (UTC), 7d, 30d and all-time, plus a verification flag ('on-chain' once volume has been observed on-chain, else 'listed'), across more than 30 facilitators. Optional daily timeseries (up to 90 days) and per-chain breakdown. Volume is decimal USD. Caveats: PER-FACILITATOR, never per-service; the *_24h fields cover today (UTC) so far, not a trailing 24 hours, and reset at 00:00 UTC, so prefer 7d.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "properties": {
      "days": {
        "type": "integer",
        "default": 30,
        "maximum": 90,
        "minimum": 1,
        "description": "Length of the timeseries in days (only used when include_timeseries is true)."
      },
      "page": {
        "type": "integer",
        "default": 1,
        "minimum": 1
      },
      "per_page": {
        "type": "integer",
        "default": 25,
        "maximum": 100,
        "minimum": 1
      },
      "timeframe": {
        "enum": [
          "24h",
          "7d",
          "30d",
          "all"
        ],
        "type": "string",
        "default": "7d",
        "description": "Drives the sort order of the returned facilitators. '24h' sorts by today (UTC) so far, not by a trailing 24-hour window."
      },
      "include_chains": {
        "type": "boolean",
        "default": false,
        "description": "Include a per-chain (network/asset) volume breakdown per facilitator."
      },
      "include_timeseries": {
        "type": "boolean",
        "default": false,
        "description": "Include a daily volume_usd / tx_count series per facilitator."
      }
    },
    "additionalProperties": false
  }

  arguments 46 lines copy
• x402_find_best_service reads open 1h ago

  Call this when you have a need in words and want one service to call rather than a list to read: it is the free ranking step between searching and paying. Pass the need as q, plus any category, network, price cap or verification requirement, and get up to 20 ranked recommendations with the basis each one placed on. Ranking is mostly per-service reliability (live status, verification, uptime, response time), x402 compliance, and price in USD, with a small (about 10%) weight on measured on-chain settlement traction that can never dominate those three. The response carries ranking_version (currently 3), need_blind_ranking (true when no q was given, so the order is global quality rather than your need), and a units map holding every scoring caveat in full: the compliance cap, the pro-quota rule for shared payout addresses, renormalization, the $10 volume floor, and the single-buyer discount. Read units before comparing scores across generations.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "properties": {
      "q": {
        "type": "string",
        "maxLength": 200,
        "minLength": 1,
        "description": "Free-text need description to match against name/description."
      },
      "limit": {
        "type": "integer",
        "default": 5,
        "maximum": 20,
        "minimum": 1,
        "description": "How many ranked recommendations to return."
      },
      "prefer": {
        "enum": [
          "balanced",
          "cheapest",
          "fastest",
          "most_reliable"
        ],
        "type": "string",
        "default": "balanced",
        "description": "Tie-breaking emphasis for the ranking weights."
      },
      "network": {
        "type": "string",
        "maxLength": 50,
        "minLength": 1,
        "description": "Required network name or abbreviation, e.g. 'Base' or 'BSE'; any network code returned by /api/v1/networks is accepted."
      },
      "category": {
        "type": "string",
        "maxLength": 100,
        "minLength": 1,
        "description": "Desired service category."
      },
      "max_price_usd": {
        "type": "number",
        "minimum": 0,
        "description": "Cap on min_price_usd in US dollars; cheaper or equal passes."
      },
      "require_verified": {
        "type": "boolean",
        "default": false,
        "description": "If true, only verified services are eligible."
      },
      "include_facilitator_context": {
        "type": "boolean",
        "default": false,
        "description": "If true, also return top facilitators by 7d settlement volume as separate ecosystem context (NOT per-service)."
      }
    },
    "additionalProperties": false
  }

  arguments 58 lines copy
• x402_search_services reads open 1h ago

  Your first call when you do not know which x402 service exists for a job: it narrows the directory of listed services to candidates. Filter by free-text query, category, network, live status, and whether the last observed 402 envelope is signable by a standard x402 client; sort by newest, uptime, cheapest, or endpoints. Returns up to 100 compact summaries a page: price in decimal USD, uptime, status, verification. Then x402_get_service for the full record.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "properties": {
      "q": {
        "type": "string",
        "maxLength": 200,
        "minLength": 1,
        "description": "Free-text search across name, description, category, base_url."
      },
      "page": {
        "type": "integer",
        "default": 1,
        "minimum": 1,
        "description": "1-based page index into the filtered result set (see meta.total_pages)."
      },
      "sort": {
        "enum": [
          "newest",
          "uptime",
          "cheapest",
          "endpoints"
        ],
        "type": "string",
        "default": "newest",
        "description": "Server-side sort order."
      },
      "fields": {
        "enum": [
          "compact",
          "full"
        ],
        "type": "string",
        "default": "compact",
        "description": "Response detail: 'compact' (default) = lean summaries (identity, price, status, uptime, verification, networks, compliance grade), 'full' = every field including the per-service assessment block. Compact keeps a directory sweep small enough to not truncate."
      },
      "status": {
        "enum": [
          "online",
          "degraded",
          "offline",
          "unknown",
          "all"
        ],
        "type": "string",
        "default": "all",
        "description": "Filter by live monitoring status."
      },
      "network": {
        "type": "string",
        "maxLength": 50,
        "minLength": 1,
        "description": "Network name or abbreviation, e.g. 'Base' or 'BSE'; any network code returned by /api/v1/networks is accepted. Omit for all."
      },
      "category": {
        "type": "string",
        "maxLength": 100,
        "minLength": 1,
        "description": "Exact category name (see categories context). Omit for all."
      },
      "per_page": {
        "type": "integer",
        "default": 25,
        "maximum": 100,
        "minimum": 1,
        "description": "Services per page, 1 to 100 (default 25). Higher values return larger results; with fields='full' a large page can be very heavy, so prefer compact when raising it."
      },
      "signable": {
        "type": "boolean",
        "description": "Filter on the signability of the last observed 402 envelope: true = no EVM route of the service was observed missing the EIP-712 domain parameters (extra.name and extra.version) that a standard x402 client requires in order to sign a payment, false = at least one such route was observed. It describes the payment envelope on the wire, not the merit of the service. A service whose latest assessment has not measured that check yet matches NEITHER value, so omit this parameter to include it. Filtered server-side, so the result total covers the whole filtered set."
      },
      "verified_only": {
        "type": "boolean",
        "default": false,
        "description": "If true, return only verified services. Filtered server-side, so the result total covers the whole verified set, not just this page."
      }
    },
    "additionalProperties": false
  }

  arguments 79 lines copy
• x402_check_health reads open 7h ago

  Call this before you send a payment, or right after a call unexpectedly failed: is this service up right now. With no slug, the directory snapshot: five status counts across the directory (include_services=true attaches every row). With a slug: that service's status, its 24h/7d/30d/90d uptime windows, response time, consecutive failures, daily snapshots. No money fields.

  mcp-tool

  1234567891011121314151617181920212223242526272829

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "properties": {
      "slug": {
        "type": "string",
        "maxLength": 200,
        "minLength": 1,
        "description": "Service slug for a single-service health report. Omit for the whole directory."
      },
      "uptime_period": {
        "enum": [
          "24h",
          "7d",
          "30d",
          "90d"
        ],
        "type": "string",
        "default": "30d",
        "description": "Daily uptime snapshot window for single-service mode."
      },
      "include_services": {
        "type": "boolean",
        "default": false,
        "description": "Directory mode only (no slug): if true, also attach the full per-service status array. Off by default so a directory health check returns just the five status counts, not every service."
      }
    },
    "additionalProperties": false
  }

  arguments 29 lines copy
• x402_assess_services moves money unknown never probed

  Call this when the free signals have run out: you hold 2 to 8 finalists from x402_search_services or x402_find_best_service, their stored fields do not separate them for YOUR stated need, and choosing wrong costs more than a quarter. It buys one fresh AI assessment reasoned against your question, not a cached grade; reading an already-computed assessment stays free via x402_get_service. Price: a one-time $0.25 USDC on Base, over two calls. Call once WITHOUT payment_signature_b64 to receive the x402 payment challenge verbatim (accepts[], amount, payTo, and a base64 PAYMENT-REQUIRED header); sign accepts[0] client-side with your own wallet; call again with the SAME question and services plus payment_signature_b64 to receive the report and a base64 PAYMENT-RESPONSE settlement receipt. This server holds no keys, never signs and never settles: it only relays the challenge. Optionally add probe { slug, endpoint_path? } to have one listed service paid and called for real and its answer analyzed: the challenge is then priced at $0.25 plus that endpoint price X, and the report gains a probe_report block with a verdict and truncated extracts, never the verbatim third-party body. When live probing is not armed the probe is ignored. Caveats: read the amount to sign from accepts[0].amount, never from a fixed figure, since a probe changes it; probe fees are non-refundable whatever the verdict; if the fresh run cannot be produced the server answers before settling, so you are never charged for nothing; there is no refund. Prices are US dollars.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "question",
      "services"
    ],
    "properties": {
      "probe": {
        "type": "object",
        "required": [
          "slug"
        ],
        "properties": {
          "slug": {
            "type": "string",
            "maxLength": 200,
            "minLength": 1,
            "description": "Slug of one listed service to probe live (must be one of the services above or another listed slug)."
          },
          "endpoint_path": {
            "type": "string",
            "maxLength": 500,
            "minLength": 1,
            "description": "Optional URL path on that service to probe, beginning with '/'. Omit to let the server pick the cheapest priced USDC-on-Base endpoint."
          }
        },
        "description": "Optional live-probe request: pay one listed service for real and analyze what it returns. When the server has probing armed the price becomes $0.25 plus that endpoint price X (non-refundable); the report gains a probe_report block with a verdict and truncated extracts, never the verbatim third-party body. Ignored when probing is not armed.",
        "additionalProperties": false
      },
      "question": {
        "type": "string",
        "maxLength": 1000,
        "minLength": 1,
        "description": "The need to assess the shortlist against (1 to 1000 characters)."
      },
      "services": {
        "type": "array",
        "items": {
          "type": "string",
          "maxLength": 200,
          "minLength": 1
        },
        "maxItems": 8,
        "minItems": 1,
        "description": "Service slugs to compare for the need (1 to 8; find them with x402_search_services or x402_find_best_service)."
      },
      "payment_signature_b64": {
        "type": "string",
        "minLength": 1,
        "description": "Base64 PAYMENT-SIGNATURE for the x402 payment, produced by signing the accepts[0] challenge client-side. Omit on the first call to receive the challenge; set it on the retry to run the paid assessment."
      }
    },
    "additionalProperties": false
  }

  arguments 55 lines copy
• x402_get_service reads unknown 1h ago

  Call this once you hold a slug and are deciding whether to commit to that service: the full record behind a directory row. Live status, uptime over 24h/7d/30d/90d, average response time, networks and settlement asset, every priced endpoint, and the assessment block. include_series=true adds 90 daily points of on-chain volume and distinct buyers. Read the units map in the response: the per-endpoint price field is atomic token units, not dollars.

  mcp-tool

  123456789101112131415161718192021

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "slug"
    ],
    "properties": {
      "slug": {
        "type": "string",
        "maxLength": 200,
        "minLength": 1,
        "description": "Service slug, e.g. 'my-api'."
      },
      "include_series": {
        "type": "boolean",
        "default": false,
        "description": "If true, also attach this service's daily on-chain series under `series` (settlement volume and distinct buyers, one point per UTC day over the most recent 90 days, oldest first). Off by default to keep the response small."
      }
    },
    "additionalProperties": false
  }

  arguments 21 lines copy

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

1 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.