Skip to main content
Glama
x402station-mcp

x402station-mcp

by sF1nX

x402station-mcp

x402station 사전 비행 오라클을 위한 MCP 어댑터입니다. Model Context Protocol을 사용하는 모든 에이전트에 preflight, forensics, catalog_decoys 도구를 제공하여, x402 엔드포인트에 결제하기 전에 데코이, 좀비 서비스, 가격 함정을 확인할 수 있게 합니다.

x402station은 agentic.market에 나열된 모든 엔드포인트를 독립적으로 조사하며(2만 개 이상의 엔드포인트, 10분마다), 촉진자 기반 모니터가 볼 수 없는 것들을 확인합니다. 여기에는 스크래핑 방지 허니팟으로 작동하는 1,000 USDC 이상의 가격이 책정된 약 161개의 엔드포인트가 포함됩니다.

설치

# Claude Code / Cursor / Windsurf / Continue — works anywhere with MCP
npm install -g x402station-mcp
# or use npx in the config, no global install needed:

Related MCP server: automaton-onchain-tools

구성

이 어댑터는 호출당 실제 USDC를 청구합니다(x402 자체를 통해 — 저희 오라클은 자체 서비스를 사용합니다). Base Sepolia USDC(또는 향후 전환 시 Base 메인넷)를 보유한 지갑 개인 키가 필요합니다.

Claude Code

~/.claude/claude_desktop_config.json(또는 MCP 서버가 있는 곳)에 추가하세요:

{
  "mcpServers": {
    "x402station": {
      "command": "npx",
      "args": ["-y", "x402station-mcp"],
      "env": {
        "AGENT_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HERE"
      }
    }
  }
}

Cursor / Windsurf / Continue

동일한 형태입니다 — 모든 MCP 호스트는 command / args / env를 이해합니다. 사용 중인 도구의 MCP 문서를 참조하세요.

환경 변수

변수

필수 여부

기본값

목적

AGENT_PRIVATE_KEY

도구 호출 시 필수

—

0x로 시작하는 64자 16진수 개인 키. 계정은 Base Sepolia USDC를 보유해야 합니다.

X402STATION_BASE_URL

아니요

https://x402station.io

개발/테스트용 재정의.

지갑용 테스트넷 USDC: faucet.circle.com (Base Sepolia 선택).

도구

preflight(url) — $0.001 USDC

이 x402 URL에 결제하는 것이 안전한지 확인합니다. 반환 값:

{
  "ok": true,
  "warnings": [],
  "metadata": {
    "service": "...",
    "price_usdc": "0.01",
    "uptime_1h_pct": 100,
    "avg_latency_ms": 412
  }
}

ok는 치명적인 경고가 발생하지 않을 때만 true입니다. 경고 종류: unknown_endpoint, no_history, dead, zombie, decoy_price_extreme, suspicious_high_price, slow, new_provider.

forensics(url) — $0.001 USDC

7일간의 심층 보고서입니다. preflight의 상위 집합입니다. 시간별 가동 시간, 지연 시간 p50/p90/p99, 상태 코드 분포, 집중 그룹 통계, 데코이 확률을 반환합니다. 추가 경고: dead_7d, mostly_dead, slow_p99, price_outlier_high, high_concentration.

catalog_decoys() — $0.005 USDC

전체 블랙리스트입니다. 현재 치명적인 것으로 표시된 모든 활성 엔드포인트와 이유별 개수를 반환합니다. 주기적으로 가져와 로컬에 캐시하세요 — 모든 URL을 preflight하는 것보다 저렴합니다.

일반적인 에이전트 흐름

agent wants data from some_endpoint.com
    │
    ├─ preflight("https://some_endpoint.com/data")  ← $0.001
    │     ok: false, warnings: ["decoy_price_extreme"]
    │
    └─ skip; try the next candidate

대량 검색의 경우, 하루에 한 번 catalog_decoys()를 수행하고 그 결과를 접속하려는 URL 집합과의 차집합으로 처리하세요.

링크

연락처

라이선스

MIT

Available Tools

10 tools
alternativesRouting fallback — siblings to a flagged endpointA

Given a URL flagged by preflight (or a taskClass hint), returns up to 5 healthy sibling endpoints in the same provider/domain/category/price-band. Filters out 7-day-dead and 1-hour-erroring candidates; ranks by uptime + latency. Costs $0.005 USDC. Use this immediately after preflight returns ok=false — it answers 'where do I go instead?'. Pass {url} when you have a specific URL the agent was about to pay; pass {taskClass} (e.g. 'llm-completions', 'Inference') when discovering by service category; or both for a richer match.

Inputs: url, taskClass, limit.

buy_creditsBuy 1000 prepaid /api/v1/preflight calls ($0.50 = 50% off)A

Bulk-prepaid preflight bundle. Pay $0.50 USDC once for 1000 prepaid /api/v1/preflight calls. Effective rate $0.0005/call (50% off the per-call $0.001 tier). Returns { creditId, balance: 1000, expiresAt }. STORE THE creditId — it's the bearer token and is not retrievable later. Pass it via X-Credit-Id header on subsequent /api/v1/preflight calls; on exhaustion (balance=0) or expiry (90 days) the middleware falls through to per-call x402 automatically. Use this once you've decided to do high-volume preflight work.

Inputs: no named parameters.

catalog_decoysFull decoy / zombie blacklistA

Returns every active x402 endpoint currently flagged decoy_price_extreme / zombie / dead_7d / mostly_dead in one JSON payload, plus per-reason counts. Costs $0.005 USDC. Pull periodically (hourly/daily) and cache locally as a blacklist — cheaper than preflighting every URL.

Inputs: no named parameters.

credits_statusRead a credit's current balance + expiryA

Free, no payment required. Returns { creditId, balance, initialBalance, used, paidAmount, createdAt, expiresAt, expired, paymentTx, paymentNetwork }. UUID-only access — anyone holding the creditId can read state, same as decrement. 404 covers both 'malformed UUID' and 'no such credit' (same body so an attacker scraping random UUIDs can't tell them apart).

Inputs: creditId (required).

forensics7-day forensics reportA

Deep history for one x402 endpoint: hourly uptime over 7 days, latency p50/p90/p99, status-code distribution, concentration-group stats (how crowded this provider's namespace is), and a decoy probability score [0, 1]. Costs $0.001 USDC. Superset of preflight — if you're running forensics you don't need preflight too.

Inputs: url (required).

preflightPre-flight safety checkA

Ask x402station whether a given x402 URL is safe to pay. Returns {ok, warnings[], metadata}. Costs $0.001 USDC (auto-signed with AGENT_PRIVATE_KEY). Call this BEFORE any other paid x402 request to avoid decoys (price ≥ $1k), zombie services, and dead endpoints. ok:true only when no critical warning fires.

Inputs: url (required).

watch_statusCheck watch subscription status + recent alertsA

Returns the current state of a watch: active/expired, alerts remaining (out of 100 prepaid), last 10 alert deliveries with their delivery_status, and the last computed signal snapshot. Free — no payment required, secret-gated. The secret is the one returned by watch_subscribe.

Inputs: watchId (required), secret (required).

watch_subscribeSubscribe to webhook alerts on x402 endpoint state changesA

Pay $0.01 USDC for a 30-day watch + 100 prepaid alerts on one x402 endpoint. When subscribed signals fire or clear (e.g. endpoint goes zombie, price flips to decoy_price_extreme), x402station POSTs a JSON payload signed with HMAC-SHA256 to your webhookUrl. Returns watchId + secret — STORE THE SECRET, it's the HMAC seed for verifying delivery payloads and is not retrievable later. signals defaults to the critical preflight subset {dead, zombie, decoy_price_extreme}; pass other names to subscribe to non-critical signals too.

Inputs: url (required), webhookUrl (required), signals.

watch_unsubscribeUnsubscribe from a watch (deactivate)A

Deactivates the watch — no further alerts will be queued or delivered. The subscription is set is_active=false but the row + alert history is retained for audit. Free — no payment required, secret-gated. There is no refund for unused prepaid alerts.

Inputs: watchId (required), secret (required).

whats_newCatalog diff polling — added / removed endpoints since `since`A

Polling-friendly catalog diff. Body { since?, limit? } (default since=now-24h, limit=200, max 500). Returns added_endpoints[] (first_seen_at >= since AND is_active=true), removed_endpoints[] (flipped to is_active=false since), service-level counts, polls_in_window, and current active totals. Cheap ($0.001 USDC) so hourly polling stays under $1/month — perfect for aggregator agents that need a fresh delta without re-pulling the whole catalog. Internal ingest cron runs every 5 min, so polling more often than that returns identical data.

Inputs: since, limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 10 tools

    Disambiguation5/5

    Each tool serves a distinct function: preflight checks, alternative endpoints, credit management, forensics, catalog blacklists, watch subscriptions, and catalog diffs. Descriptions are detailed, leaving no ambiguity about tool purposes.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (e.g., buy_credits, watch_subscribe, whats_new), making predictions and selection straightforward for an agent.

    Tool Count5/5

    With 10 tools, the server covers its domain of endpoint safety monitoring, credit management, and subscription alerts without being overly bloated or sparse.

    Completeness4/5

    The tool surface covers the main workflow: preflight checks, alternatives, credit buying, status, forensics, blacklisting, watching, and polling. A minor gap is the lack of a free endpoint status query for a single URL, but the paid preflight covers it.

    Maintenance

    ActivityInactive
    ResponsivenessMixed handling

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Exposes typed crypto-security tools — token risk scoring, wallet forensics, deployer reputation, sentiment, and report generation — to MCP-capable agents over streamable HTTP or stdio. Gates premium calls behind per-request x402 crypto micropayments, delegating verification and settlement to a self-hosted facilitator and failing closed when payment cannot be confirmed.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to access pay-per-call onchain and URL safety APIs over MCP, covering transaction explanations, token approval checks, address inspection, contract risk heuristics, URL safety, gas snapshots, ENS resolution, calldata decoding, and wallet portfolio data. Payments are handled per call in USDC on Base via x402, with no signup or API key required.
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to run a free fail-closed preflight gate on x402 payment challenges and transactions before signing, plus five USDC-paid on-chain truth checks covering arbitrage profitability, token safety, swap routing, quote validation, and trade sizing. Each check returns a verdict with pinned-block evidence and a verifiable receipt.
      4
      9
      Apache 2.0
    • A
      license
      A
      quality
      B
      maintenance
      Lets AI clients call paid x402ai endpoints — embeddings, summaries, and short answers — paying per call in USDC on Base via the x402 protocol, with per-payment and per-session spend caps plus a free inspector for decoding any x402 endpoint's payment challenge. Runs locally over stdio, needs no hosted account, and can operate in quote-only dry-run mode.
      5
      274 npm
      MIT