Stride20k x402 Data Gateway

io.github.MarysbrainPublished by GitHub account Marysbrainv0.2.0Updated Oct 24, 2026

x402 analytics feed + 20+ pay-per-call agent tools over x402 (data, LLM, risk), no accounts.

VerifiedSTDIODesktop onlyFinanceDeveloper ToolsData & Analytics

Overview

AI-generated overview

A local MCP server giving an assistant a free x402 market feed plus paid, pay-per-call diligence tools that spend USDC from a funded wallet.

What you can do
Read a free x402 ecosystem snapshot: service listings by category with week-over-week deltas, new listings, npm download trends, protocol release tags and per-source reliability grades, each with a freshness stamp. Check x402 category coverage before committing spend. Run a resource preflight that checks reachability, terms, catalog presence and observed age before an agent pays. Call further paid data, LLM and risk tools whose prices are stated in each tool description. Enforce per-call and per-session spending caps that refuse calls before any payment is signed.
When to use it
Useful when an assistant needs current x402 ecosystem data, or needs to vet a paid x402 resource before spending on it. The free feed alone is worth adding if you only want market visibility; the paid tools matter when you are willing to fund a small wallet.
Requirements
Runs locally via npx (Node.js). Needs network access to the gateway, whose base URL can be overridden with GATEWAY_URL. Paid tools need WALLET_PRIVATE_KEY for a wallet holding USDC on Base; free previews work without it. Optional caps MAX_PER_CALL_USD and MAX_SESSION_USD, plus pinned EXPECTED_PAY_TO and EXPECTED_SIGNING_KID.
Before you install
WALLET_PRIVATE_KEY signs real payments; use a dedicated wallet with only a few dollars of USDC, never a main wallet. Paid calls spend money, and a transport or body-read error after payment authorization reserves the full advertised amount as possibly spent, so reconcile the wallet before retrying. The README marks this repository as retired and says not to install or deploy from it, though existing deployments continue. Tool definitions are fetched from a remote signed manifest at startup.

Installation

In SourceWeft

  1. Open Stride20k x402 Data Gateway in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Retired source — recovery reference

Active maintenance moved to the sole maintained private repository Marysbrain/aye-today, in packages/mcp/.

Do not install or deploy from this retired repository. The historical instructions below are retained for recovery and reference, not current operations.

Existing public deployments continue unchanged. Repository retirement does not delete or shut down services. Original source and Git history remain preserved; retired repository workflows are disabled.

Retirement notice: 2026-09-03.

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, Aye Scout exposes two paid pre-payment diligence tools: x402 category coverage and a resource preflight that checks reachability, terms, catalog presence, and observed age before an agent spends. The tool list is fetched from the signed public manifest at startup; compatibility-only routes are deliberately absent (verify).

The manifest is verified over its exact response bytes before any paid tools are registered. Both the treasury address and gateway signing-key ID are pinned; an unsigned manifest or an unexpected key rotation stops startup.

⚠️ 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"      }    }  }}
  1. 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.01 USDC per call] Score an x402 resource before paying it…

Spend guardrails

  • MAX_PER_CALL_USD (default 0.25): tools priced above this are refused.
  • 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

VarDefaultPurpose
GATEWAY_URLhttps://pulse.aye.todayGateway 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_USD0.25Per-call cap
MAX_SESSION_USD2.00Per-session cap
EXPECTED_PAY_TOAye treasury addressPinned payment destination; override only for a controlled test deployment
EXPECTED_SIGNING_KIDAye production key IDPinned manifest signing key; rotate only with an audited gateway release

If a transport or body-read error occurs after payment authorization, the MCP reserves the full advertised amount as possibly spent. It will not silently restore that session capacity; reconcile the wallet before retrying.

Source: README.md at commit f06056c

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.0LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.