rippermercs avatar

TensorFeed x402 Base Reader

rippermercs/tensorfeed-x402-base-mcp

Read-only Base mainnet verifier for x402 payment settlements. Connects your MCP client to Base's public RPC and exposes tools to verify USDC transfers on-chain, parse publisher manifests from `.well-known/x402`, decode payment headers, and audit receipts without touching a private key. Complements Coinbase's official Base MCP: that one signs transactions, this one independently confirms they happened. Ships with generic chain readers (balance, block number, tx receipts) plus x402-native tooling (verify_x402_settlement, probe_x402_endpoint, decode_x402_payment_payload). TensorFeed-flavored extras check AFTA federation status and lookup payments to TF's canonical wallet. Useful when an agent receives an x402 receipt and needs cryptographic proof the merchant didn't lie about the settlement.

GitHub stars
1
tools
15
auth
Secret needed
transport
STDIO
env var
1
last updated
May 28, 2026

Tools

15 tools

Public tool metadata for what this MCP can expose to an agent.

balanceNative ETH balance for an address

Native ETH balance for an address

No parameter schema in public metadata yet.

usdc_balanceUSDC (Circle native bridged) balance for an address

USDC (Circle native bridged) balance for an address

No parameter schema in public metadata yet.

block_numberLatest Base block number

Latest Base block number

No parameter schema in public metadata yet.

get_tx_receiptFull tx receipt with status, gas, and logs summary

Full tx receipt with status, gas, and logs summary

No parameter schema in public metadata yet.

callRead-only contract call (eth_call, never broadcasts)

Read-only contract call (eth_call, never broadcasts)

No parameter schema in public metadata yet.

recent_transfersUSDC Transfer events involving an address over N blocks

USDC Transfer events involving an address over N blocks

No parameter schema in public metadata yet.

verify_x402_settlementGiven a tx hash, expected recipient, and expected USDC amount, returns a structured verdict on whether the on-chain Transfer event matches.

Given a tx hash, expected recipient, and expected USDC amount, returns a structured verdict on whether the on-chain Transfer event matches.

No parameter schema in public metadata yet.

parse_x402_manifestFetches https://{domain}/.well-known/x402.json, returns the structured manifest.

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

No parameter schema in public metadata yet.

usdc_recent_payments_toUSDC transfers TO an address over N blocks; the merchant-side view.

USDC transfers TO an address over N blocks; the merchant-side view.

No parameter schema in public metadata yet.

probe_x402_endpointProbes any https URL and reports whether it returns a canonical x402-paid 402 response with accepts[].

Probes any https URL and reports whether it returns a canonical x402-paid 402 response with accepts[].

No parameter schema in public metadata yet.

decode_x402_payment_payloadOffline decode of a base64 X-PAYMENT header (Coinbase x402 V2): returns scheme, network, version, EIP-3009 authorization, signature.

Offline decode of a base64 X-PAYMENT header (Coinbase x402 V2): returns scheme, network, version, EIP-3009 authorization, signature.

No parameter schema in public metadata yet.

verify_afta_federationCalls TensorFeed's AFTA certification endpoint for a domain, returns a scored checklist.

Calls TensorFeed's AFTA certification endpoint for a domain, returns a scored checklist.

No parameter schema in public metadata yet.

tf_payment_lookupChecks whether a tx hash is a USDC payment to TensorFeed's canonical wallet on Base.

Checks whether a tx hash is a USDC payment to TensorFeed's canonical wallet on Base.

No parameter schema in public metadata yet.

x402_publisher_healthReturns current outcome + 24h/7d uptime + recent series for a domain monitored by TensorFeed's hourly x402 status probe.

Returns current outcome + 24h/7d uptime + recent series for a domain monitored by TensorFeed's hourly x402 status probe.

No parameter schema in public metadata yet.

afta_federation_membersReturns the canonical curated list of confirmed AFTA federation members (TF origin + federated members).

Returns the canonical curated list of confirmed AFTA federation members (TF origin + federated members).

No parameter schema in public metadata yet.

Sponsors

Configuration

TENSORFEED_RPC_URLsecret

Optional Base mainnet RPC endpoint (Alchemy, Infura, etc) for higher rate limits. Must match the allowlist in src/rpc/allowlist.ts; non-allowlisted URLs fall back to public Base RPC with a stderr warning. Defaults to https://mainnet.base.org if unset.

Readme

@tensorfeed/x402-base-mcp

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.

npm install -g @tensorfeed/x402-base-mcp

Relationship to Coinbase Base MCP

Coinbase shipped Base MCP (the official mcp.base.org server, launched May 2026) as the transact-side MCP: it connects an agent to a Base Account and lets the agent propose swaps, transfers, and x402 payments that the user approves in-wallet.

This package, @tensorfeed/x402-base-mcp, is the verify-side MCP. Once an x402 payment has been made (by Base MCP, by a server-side @coinbase/x402 middleware, or by any other x402 client), this server lets the calling agent independently check the on-chain settlement, parse the publisher's /.well-known/x402 manifest, and audit the receipt. Read-only chain visibility, no wallet.

The two are complementary, not competing. Use Base MCP to pay. Use this MCP to verify.


View the full README on GitHub

Details

Repository
github.com/rippermercs/tensorfeed-x402-base-mcp
Website
tensorfeed.ai/x402
Category
Finance & Commerce
Package
@tensorfeed/x402-base-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from rippermercs

Related Finance & Commerce MCP servers

View all
1artgas1 avatarRobokassa Mcpartgas1/robokassa-mcpComprehensive MCP server for the Robokassa payment gateway (18 tools, full API coverage).1stars
2casterdly avatarJarvis Market Signalscasterdly/jarvis-market-signalsLive crypto market signals for AI agents: perp liquidations, funding, OI positioning, yield, FX.1stars
3cloakedagent avatarCloaked Agentcloakedagent/cloakedTrustless spending accounts for AI agents on Solana with on-chain enforced limits.1stars
4emmanuel39hanks avatarCoal — Payments for AI agentsemmanuel39hanks/coalPayment rails for AI agents. Pay merchants in USDC on Base. Dual-protocol: x402 + OKX APP.1stars
5hyperd-ai avatarHyperd Mcphyperd-ai/hyperd-mcpPre-trade DeFi intelligence: 24 paid x402 tools incl. 6 synthesis verdicts, USDC on Base.1stars
6cryptoapis-io avatarMcp Hd Walletcryptoapis-io/cryptoapis-mcp-hd-walletMCP server for HD wallet management, balance, and sync on EVM, UTXO, XRP via Crypto APIs0stars