x402station-mcp

Q: Where can I get more information or report issues?

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

@sF1nX

Repository

About x402station-mcp

MCP adapter for x402station.io — infrastructure for x402 agentic

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

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.

Frequently asked questions

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?

Where can I get more information or report issues?

Comments

Basic information

More Other MCP servers

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

MCP Registry

modelcontextprotocol

A community driven registry service for Model Context Protocol (MCP) servers.

7.0K

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

ACI: Open-Source Infra to Power Unified MCP Servers

aipotheosis-labs

ACI.dev is the open source tool-calling platform that hooks up 600+ tools into any agentic IDE or custom AI agent through direct function calling or a unified MCP server. The birthplace of VibeOps.

4.8K