TensorFeed x402 Base Reader MCP Server

Read-only MCP server for verifying x402 USDC settlements on Base mainnet. Drop it into any MCP-compatible agent (Claude Desktop, Claude Code, Cursor, ChatGPT) to independently audit x402 payment receipts on-chain, parse publisher .well-known/x402 manifests, and check AFTA federation status. No private keys, no signing, no broadcasts. Its 15 documented tools cover x402, balance, usdc, recent.

People connecting finance tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-12 · ★ 2 · #77 OF 283 MAINTAINED FINANCE · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install TensorFeed x402 Base Reader

before you install - you'll need

Set TENSORFEED_RPC_URL before connecting.

Claude Code

claude mcp add rippermercs-tensorfeed-x402-base-mcp -- npx -y @tensorfeed/x402-base-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "rippermercs-tensorfeed-x402-base-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tensorfeed/x402-base-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @tensorfeed/x402-base-mcp - the @tensorfeed scope differs from the repo owner (rippermercs); confirm it's the project's official package

registry vendor namespace ai.tensorfeed - domain-verified with the official MCP registry

03 · What TensorFeed x402 Base Reader can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can fetch https://{domain}/.well-known/x402.json, returns the structured manifest, check whether a tx hash is a USDC payment to TensorFeed's canonical wallet on Base, and read current outcome + 24h/7d uptime + recent series for a domain monitored by TensorFeed's hourly x402 status probe.

Capability map

Tools grouped from the project's README - what TensorFeed x402 Base Reader lets an agent do.

Usdc

2 tools - e.g. USDC (Circle native bridged) balance for an address; USDC transfers TO an address over N blocks; the merchant-side view.

usdc_balance · usdc_recent_payments_to

Verify

2 tools - e.g. Given a tx hash, expected recipient, and expected USDC amount, returns a structured verdict on whether the on-chain Transfer event matches.; Calls TensorFeed's AFTA certification endpoint for a domain…

verify_x402_settlement · verify_afta_federation

Balance

1 tool - e.g. Native ETH balance for an address

balance

Block

1 tool - e.g. Latest Base block number

block_number

read & search

1 tool - e.g. Full tx receipt with status, gas, and logs summary

get_tx_receipt

run & execute

1 tool - e.g. Read-only contract call (eth_call, never broadcasts)

call

Recent

1 tool - e.g. USDC Transfer events involving an address over N blocks

recent_transfers

Parse

1 tool - e.g. Fetches https://{domain}/.well-known/x402.json, returns the structured manifest.

parse_x402_manifest

04 · Who maintains TensorFeed x402 Base Reader

TensorFeed x402 Base Reader is maintained by rippermercs. We track 3 MCP servers from rippermercs - 2 actively maintained, 3 combined GitHub stars, oldest repo from May 2026.

05 · Facts

repository: github.com/rippermercs/tensorfeed-x402-base-mcp
website: https://tensorfeed.ai/x402
category: finance - ranked #77 of 283 actively-maintained finance servers as of 2026-08-25.
registry: ai.tensorfeed/x402-base-mcp (active, first published 2026-05-12 · 5 versions)
packages: npm:@tensorfeed/x402-base-mcp

06 · TensorFeed x402 Base Reader FAQ

Is TensorFeed x402 Base Reader still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-12. We re-verify nightly.

What can TensorFeed x402 Base Reader do?

How do I install TensorFeed x402 Base Reader?

Run `npx -y @tensorfeed/x402-base-mcp`. The README documents one environment variable (TENSORFEED_RPC_URL) to set first. Set TENSORFEED_RPC_URL before connecting. You can also paste the ready-made client config above.

Does TensorFeed x402 Base Reader run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to TensorFeed x402 Base Reader

Alternatives to TensorFeed x402 Base Reader

Maintained finance servers if TensorFeed x402 Base Reader isn't the fit.

Pairs well with

Servers that cover what TensorFeed x402 Base Reader doesn't - only shown when the pairing reason fits the companion.

More finance MCP servers · Sports Card Agent · Roamzy Io MCP Server · Agentpay · Polymarket Toolkit · Undesirables MCP Server

More TypeScript MCP servers · Claude Prompt Optimizer · Gemini MCP · Groundtruth · Qseow MCP · Rn Devtools Hub · see all