io.github.printmoneylab/x402watch

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Wash-filtered intelligence for x402: categories, services, wash analysis, trends.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "x402watch": {
      "url": "https://api.x402.printmoneylab.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (5)

• x402_get_categories

  List all 33 x402 service categories with aggregate stats: services count, 24h volume, transaction count, real-volume %, and label distribution. Use this to understand the shape of the x402 ecosystem before drilling into specific services or wallets. Free tier. No payment required. Returns wash-filtered data using the same v2.0 algorithm as the paid endpoints.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• x402_get_service

  Get the full detail record for one x402 service: name, description, seller address, chain, price, 24h and total transaction stats, 30-day daily volume time series, buyer-label distribution, and top buyers. Use this to evaluate a single service's traffic composition. Free tier. No payment required. Returns wash-filtered data using the same v2.0 algorithm as the paid endpoints.

  Parameters:

  • service_id (required) — integer — Numeric x402 service id (visible in /services list and detail URLs).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• x402_check_wash

  Get the aggregate wash-report dataset: 30-day total active buyers, real-volume %, suspected_wash and self_test counts, full 8-label distribution, 14-day wash percentage time series, and five anonymized case studies (Service A through E) with pattern signals. For per-address real-time wash analysis with full signal breakdown, use the paid POST /api/v1/wash/check HTTP endpoint ($0.05 USDC) — that endpoint speaks x402, agents pay and receive data in a single HTTP round-trip. Free tier. No payment required. Returns wash-filtered data using the same v2.0 algorithm as the paid endpoints.

  Parameters:

  • address — string — Optional wallet or seller address. When provided, the response includes a hint about the paid per-address endpoint.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• x402_search_services

  Search the index of 36k+ x402 services with filters. Returns a paginated list of matching services with their stats and label mix. Use this to find services by topic, chain, or seller wallet. Free tier. No payment required. Returns wash-filtered data using the same v2.0 algorithm as the paid endpoints.

  Parameters:

  • page — integer — 1-indexed page number.
  • sort — string — Sort key: tx_24h | volume_24h | tx_total | price | real_pct | wash_pct | first_seen | alpha.
  • chain — string — Filter to one chain: 'base', 'solana', 'arbitrum', 'base-sepolia'.
  • search — string — Free-text match against name, description, or seller address.
  • category — string — Filter to a single category slug (e.g. 'ai_inference', 'wallet_analytics').
  • page_size — integer — Page size (max 200; default 24).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• x402_get_trends

  Get the last-24-hour trends snapshot: new services count vs the previous 24h, total transaction count, total USDC volume, active buyer count, daily new-services bar (14 days), recent new services (top 10), category volume movers, and hot services with traffic surges (>= 100 24h tx and >= +50% growth). Refreshed every 5 min. Free tier. No payment required. Returns wash-filtered data using the same v2.0 algorithm as the paid endpoints.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.