
TensorFeed x402 Base Reader
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 toolsPublic 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_URLsecretOptional 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.
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