X402watch

io.github.printmoneylabPublished by GitHub account printmoneylabv1.0.0Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingFinanceData & Analytics

Overview

AI-generated overview

Remote MCP server exposing wash-filtered analytics on the x402 payments ecosystem: service categories, individual services, search, trends and wash reports.

What you can do
  • Browse and search the x402 service index: list the 33 categories with volume and label stats, search 36k+ services by topic, chain or seller wallet, and pull one service's full record with 30-day volume and top buyers.
  • Review ecosystem trends: 24-hour snapshot of new services, transaction counts, USDC volume, category movers and hot services.
  • Inspect wash activity: aggregate wash report with buyer-label distribution, 14-day wash percentage series and anonymized case studies.
  • All five tools are read-only and free; per-address wash checks are only available through the separate paid REST endpoint.
When to use it
Useful when you want an assistant to research the x402 ecosystem — sizing categories, comparing services, spotting traffic surges, or judging whether reported volume looks organic rather than self-funded.
Requirements
A remote streamable-http endpoint; no package install, API key or account needed for the MCP tools. The free REST API behind it is rate limited to 60 requests per hour per IP.
Before you install
The MCP tools are read-only and free, but the README's paid REST endpoints cost USDC on Base mainnet and require a wallet private key in the client environment; that is separate from this server and should not be wired in casually. Wash labels are heuristic classifications of on-chain wallets, so treat them as signals, not verdicts.

Installation

In SourceWeft

  1. Open X402watch in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.printmoneylab%2Fx402watch/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

x402watch

Wash-filtered intelligence layer for the x402 ecosystem — free public dashboard, daily CC0 datasets, x402-native paid API, and a remote MCP server.

[Live] [License: Apache 2.0] [Data: CC0] [MCP Registry] [Smithery] [Glama]

What is x402watch

Public x402 dashboards count transactions. x402watch classifies them.

Every active buyer wallet is tagged with one of eight labels — organic_user, self_test, developer, suspected_wash, ai_agent, analytics_bot, exchange_user, or verifier — using cohort signals + vanity clustering. Real-volume reporting excludes the synthetic categories, so service rankings reflect actual demand instead of self-funded noise.

4-Axis Differentiation

  1. Wash filter — 8-label buyer classification, cohort signal detection (uniform_amount, coordinated_start, uniform_tx_count, time_burst), strict + broad vanity clustering, conservative developer label.
  2. Free public data — every label, every benchmark. Daily CC0 snapshots in printmoneylab/x402watch-data.
  3. AI-native — public REST API, x402-native paid endpoints, llms.txt, OpenAPI spec, RSS, /.well-known/x402, and an MCP server.
  4. Coverage — 36,000+ services indexed across Base, Solana, Polygon, and Arbitrum.

Quick Start

Free API

bash
curl https://api.x402.printmoneylab.com/api/v1/landing-statscurl https://api.x402.printmoneylab.com/api/v1/categoriescurl 'https://api.x402.printmoneylab.com/api/v1/services?search=ai'

Rate limit: 60 req/hour per IP. No API key. CC0-licensed.

MCP server (one command)

bash
smithery mcp add bakyang2/x402watch

Or add to any MCP client manually (Claude Desktop, Cursor, Cline):

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

Paid endpoint (x402)

python
import asyncio, osfrom eth_account import Accountfrom x402 import x402Clientfrom x402.mechanisms.evm.exact import ExactEvmClientSchemefrom x402.http.clients.httpx import x402HttpxClient
async def main():    acct = Account.from_key(os.environ["PRIVATE_KEY"])    payer = x402Client()    payer.register("eip155:8453", ExactEvmClientScheme(acct))    async with x402HttpxClient(payer, base_url="https://api.x402.printmoneylab.com") as c:        r = await c.post("/api/v1/wash/check", json={"address": "0x..."})        print(r.json()["label"])
asyncio.run(main())

The 402 round-trip pays USDC on Base mainnet via the CDP facilitator, retries with the signed payment header, and returns 200 with the data — no signup, no API keys.

API Endpoints

Free (60 req/hour per IP)

EndpointDescription
GET /api/v1/landing-statsReal-time market overview (services, transactions, real volume %)
GET /api/v1/categoriesAll 33 x402 service categories with stats
GET /api/v1/categories/{slug}Category detail + 30-day time series + top services
GET /api/v1/servicesPaginated service list with filters
GET /api/v1/services/{id}Service detail: stats, time series, top buyers, label distribution
GET /api/v1/trends24-hour ecosystem trends
GET /api/v1/wash-reportAggregate wash patterns + anonymized case studies

Paid (x402, USDC on Base)

EndpointPriceUse case
GET /api/v1/services/{id}/wash-detail$0.005Operator audit — top 50 buyers + signal breakdown
GET /api/v1/buyers/{address}/profile$0.005Wallet research
GET /api/v1/services/{id}/transactions$0.01Custom analysis — raw 30-day transactions
GET /api/v1/categories/{slug}/full-history$0.02Longitudinal research — 365-day hourly series
POST /api/v1/wash/check$0.05Real-time wash analysis for any address

Settled via the Coinbase Developer Platform x402 facilitator. Bazaar discovery extensions declared per route.

Full reference: /api · Swagger UI

MCP Tools

Listed on the official MCP Registry as io.github.printmoneylab/x402watch. Streamable-http at https://api.x402.printmoneylab.com/mcp. Five read-only tools:

ToolWhat it returns
x402_get_categoriesAll 33 categories with services count, 24h volume, real-volume %, label distribution
x402_get_serviceOne service's full record: stats, 30-day daily volume, top buyers, label mix
x402_check_washAggregate wash-report dataset (per-address analysis is the paid POST /wash/check endpoint)
x402_search_servicesSearch 36k+ services with filters (category, chain, sort, page)
x402_get_trends24h trends: new services, hot services, category volume movers

Architecture

LayerStack
FrontendNext.js 16 (App Router) + Tailwind v4 + Recharts
BackendFastAPI + PostgreSQL (TimescaleDB) + Redis (5-min cache)
IndexingBazaar discovery + EVM RPC (Alchemy) + Solana RPC (Helius)
Wash detectionNetworkX cohort signals, vanity clustering (strict + broad), single-buyer concentration analysis
AI classificationClaude Haiku 4.5 (per-service categorization), Claude Sonnet 4.5 (cross-validation)
Paymentsx402 SDK 2.8.0, CDP facilitator on Base mainnet (USDC)
MCP serverFastMCP 3.x, streamable-http transport
HostingOracle ARM (backend, free tier) + Vercel (frontend) + Cloudflare DNS

Methodology

Open, version-controlled, deterministic from public on-chain data:

→ https://x402.printmoneylab.com/docs/methodology

Covers 8-label priority order, cohort signal thresholds, vanity-cluster math, and the conservative developer label. Source markdown lives in content/methodology.md.

Resources

Repository Layout

This repo holds the public Next.js site under src/. The methodology markdown lives in content/methodology.md and is rendered at /docs/methodology. The FastAPI backend and indexers live on a separate Oracle host.

Contributing

Pull requests welcome. For methodology questions, dispute a label, or report a misclassified service, please open a GitHub Issue — labels are deterministic and reproducible from public on-chain data, so we'll walk through the signals that triggered the classification.

License

Status

Phase 1 MVP — actively developed. 9 systemd services running on the Oracle backend (api, mcp, 7 indexer/labeller/stats jobs). Daily snapshots commit to the data repo at 04:00 UTC.


Built by PrintMoneyLab.

Source: README.md at commit ca0cb71

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.

Takes no parameters.

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.

Parametersservice_idrequired

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.

Parametersaddress

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.

Parameterspagesortchainsearchcategorypage_size

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts