# Stride20k x402 Data Gateway

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/Marysbrain/x402-gateway-mcp  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/stride20k-x402-data-gateway

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

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "stride20k-x402-data-gateway": {
    "command": "npx",
    "args": ["-y","stride20k-x402-data-gateway"]
  }
}
```

## Documentation & README

# x402-gateway-mcp

**The live x402 market feed for agents.** The `x402_market_pulse` tool is
FREE — no wallet, no payment, no signup: the x402 ecosystem in one snapshot,
refreshed ~3x/day — service listings by category with week-over-week deltas,
newly listed services, npm download trends for the core x402 packages,
protocol release tags, and per-source reliability grades. Every metric
carries a freshness stamp; a stale source says so instead of pretending.

Behind the feed: every [x402-gateway](https://gateway.stride20k.com) data
endpoint as an MCP tool that **pays for calls with your wallet** (USDC on
Base, x402 protocol) — crypto prices, DEX pools, gas, FX, Treasury yields,
US weather, WHOIS, DNS, email validation, web-to-markdown extraction, token
risk scores, $1 domain dossiers, and more. Tool list is fetched from the
gateway's `/.well-known/x402.json` at startup — new gateway endpoints appear
automatically, and every response is cryptographically signed
([verify](https://gateway.stride20k.com/llms.txt)).

> ⚠️ **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)

1. 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).
2. `npm install -g x402-gateway-mcp` (or use `npx`).
3. Add to your MCP config (Claude Desktop `claude_desktop_config.json`, or
   `claude mcp add` for Claude Code):

```json
{
  "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"
      }
    }
  }
}
```

4. Restart the client. The free `x402_market_pulse` tool works immediately
   (no wallet needed); every paid 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 |