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

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

XcodeBuildMCP

cameroncooke

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0K

Nginx UI

0xJacky

Yet another WebUI for Nginx

11.3K

Inbox Zero AI MCP

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K