Is X402 Gateway free?

Yes, X402 Gateway is free to use.

How do I install X402 Gateway?

X402 Gateway is a local plugin. Install it using npm package: x402-gateway-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is X402 Gateway safe to use?

Yes. X402 Gateway passed MCP Marketplace's automated security scan with a score of 10/10 (low risk). Every server on MCP Marketplace is security-scanned before it's listed; see the full security report on this page for the findings and permissions.

What credentials does X402 Gateway need?

X402 Gateway requires the following credentials or environment variables: WALLET_PRIVATE_KEY, MAX_PER_CALL_USD, MAX_SESSION_USD, GATEWAY_URL. You can find setup instructions on the server detail page.

What AI apps work with X402 Gateway?

X402 Gateway uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

X402 Gateway MCP Server

by Marysbrain

Developer ToolsLow Risk10.0MCP RegistryLocal

Free

Server data from the Official MCP Registry

17 pay-per-call data tools via x402 (USDC on Base): crypto, FX, weather, WHOIS, web, token risk.

About

17 pay-per-call data tools via x402 (USDC on Base): crypto, FX, weather, WHOIS, web, token risk.

Security Report

10.0

Low Risk10.0Low Risk

Valid MCP server (2 strong, 4 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

4 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Buyer wallet key (fund with a few USDC on Base). Optional: free previews work without it.Required

Environment variable: WALLET_PRIVATE_KEY

Refuse any single call above this price. Default 0.25; set 1.25 to enable the $1 domain dossier.Optional

Environment variable: MAX_PER_CALL_USD

Total spend cap per session. Default 2.00.Optional

Environment variable: MAX_SESSION_USD

Gateway base URL override. Default https://gateway.stride20k.com.Optional

Environment variable: GATEWAY_URL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-marysbrain-x402-gateway-mcp": {
      "env": {
        "GATEWAY_URL": "your-gateway-url-here",
        "MAX_SESSION_USD": "your-max-session-usd-here",
        "MAX_PER_CALL_USD": "your-max-per-call-usd-here",
        "WALLET_PRIVATE_KEY": "your-wallet-private-key-here"
      },
      "args": [
        "-y",
        "x402-gateway-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

x402-gateway-mcp

Stdio MCP server that exposes every x402-gateway data endpoint as an MCP tool and pays for calls with your wallet (USDC on Base, x402 protocol). Tool list is fetched from the gateway's /.well-known/x402.json at startup — new gateway endpoints appear automatically.

⚠️ Funded-wallet warning: WALLET_PRIVATE_KEY signs real payments. Use a dedicated wallet holding only small balances (a few dollars of USDC). Never your main wallet. The key is read from env, never logged, and payment headers are never echoed into agent-visible output.

5-minute setup (Claude Desktop / Claude Code)

Create a fresh wallet and fund it with a small amount of USDC on Base (or Base Sepolia test USDC from https://faucet.circle.com while testing).
npm install -g x402-gateway-mcp (or use npx).
Add to your MCP config (Claude Desktop claude_desktop_config.json, or claude mcp add for Claude Code):

{
  "mcpServers": {
    "x402-gateway": {
      "command": "npx",
      "args": ["-y", "x402-gateway-mcp"],
      "env": {
        "GATEWAY_URL": "https://<your-gateway-host>",
        "WALLET_PRIVATE_KEY": "0x<small-balance-wallet-key>",
        "MAX_PER_CALL_USD": "0.25",
        "MAX_SESSION_USD": "2.00"
      }
    }
  }
}

Restart the client. Every tool description states its price, e.g. [costs $0.005 USDC per call] Get the current USD price of a cryptocurrency…

Spend guardrails

MAX_PER_CALL_USD (default 0.25): tools priced above this are refused. Note: the gateway's premium /report/domain dossier costs $1.00 — set MAX_PER_CALL_USD=1.25 to enable it; the default deliberately keeps premium tools opt-in.
MAX_SESSION_USD (default 2.00): cumulative settled spend per server session; calls that would exceed it are refused with a clear message the agent can relay. Restart the server to reset.

Refusals happen before any payment is signed.

Env reference

Var	Default	Purpose
`GATEWAY_URL`	`https://gateway.stride20k.com`	Gateway base URL (override for local/testnet)
`WALLET_PRIVATE_KEY`	—	Buyer key (small balance!). Without it, tools list but calls fail with a clear error
`MAX_PER_CALL_USD`	`0.25`	Per-call cap
`MAX_SESSION_USD`	`2.00`	Per-session cap

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

X402 Gateway MCP Server

About

Security Report

Findings (1)

Permissions Required

What You'll Need

How to Install

Documentation

x402-gateway-mcp

5-minute setup (Claude Desktop / Claude Code)

Spend guardrails

Env reference

Reviews

No reviews yet

More Developer Tools MCP Servers

Git

Fetch

Toleno

mcp-creator-python

MarkItDown

MCP Marketplace