x402station-mcp

Name: x402station-mcp
Author: sF1nX

@sF1nX

Repository

About x402station-mcp

MCP adapter for x402station.io — infrastructure for x402 agentic

#x402 #oracle #agentic-commerce #payments #base #coinbase #decoy-detection #mcp

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "x402station": {
      "command": "npx",
      "args": [
        "-y",
        "x402station-mcp"
      ],
      "env": {
        "AGENT_PRIVATE_KEY": "0x<your-base-mainnet-private-key>"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is x402station-mcp?

x402station-mcp is an MCP adapter for x402station.io, the infrastructure for x402 agentic commerce. It exposes Preflight by x402station.io (the active flagship product, Evaluate direction) plus tools across all six capability directions: Discover (Catalog), Evaluate (Preflight), Pay (Credits), Monitor (Watch), Recover (Alternatives), Analyze (Forensics). Any agent speaking the Model Context Protocol gets one-call safety before signing PAYMENT-SIGNATURE — flags decoys, zombie services, dead endpoints, and price traps before paying them.

How to use x402station-mcp?

Install globally via npm install -g x402station-mcp or use npx in the MCP config. The adapter charges real USDC per call; you need a wallet private key that holds Base Sepolia USDC (or Base mainnet once switched). Configure the environment variable AGENT_PRIVATE_KEY in your MCP host settings (e.g., ~/.claude/claude_desktop_config.json). Optionally set X402STATION_BASE_URL to override the default https://x402station.io.

Key features of x402station-mcp

Preflight check for x402 URLs ($0.001 USDC per call)
Forensics deep 7-day report (superset of preflight)
Catalog decoys blacklist ($0.005 USDC per call)
Independent probing every 10 minutes of endpoints on agentic.market
Detects endpoints priced ≥ $1,000 USDC as anti-scraper honeypots
Compatible with Claude Code, Cursor, Windsurf, Continue, and any MCP host

Use cases of x402station-mcp

Ask whether it's safe to pay a given x402 URL before sending payment
Get a deep 7-day forensic report on an endpoint's reliability and risk
Retrieve a full blacklist of currently flagged decoy or dead endpoints
Bulk-set-difference check against URLs before hitting them, using cached catalog
Agent workflow: preflight a candidate endpoint and skip if warnings fire

FAQ from x402station-mcp

What does preflight return?

ok is true only when no critical warning fires. Warnings include unknown_endpoint, no_history, dead, zombie, decoy_price_extreme, suspicious_high_price, slow, and new_provider. Response also includes metadata like service name, price in USDC, uptime, and average latency.

What tools are available and how much do they cost?

preflight(url) costs $0.001 USDC, forensics(url) costs $0.001 USDC, and catalog_decoys() costs $0.005 USDC per call. All charges are in real USDC via x402.

What are the runtime requirements?

A wallet private key (AGENT_PRIVATE_KEY) that holds Base Sepolia USDC is required for any tool call. Testnet USDC can be obtained from faucet.circle.com (pick Base Sepolia). Optionally set X402STATION_BASE_URL for dev/testing.

How does x402station.io detect risky endpoints?

It independently probes every endpoint listed on agentic.market every 10 minutes. It can see endpoints priced ≥ $1,000 USDC that function as anti-scraper honeypots, which facilitator-based monitors cannot.

Where can I get more information or report issues?

General and commercial inquiries: [email protected]. Bug reports: github.com/sF1nX/x402station-mcp/issues. Security disclosures: x402station.io/.well-known/security.txt. OpenAPI spec: x402station.io/api/openapi.json.