MCP.so
Sign In

Tensorfeed X402 Base Mcp

@RipperMercs

Repository

About Tensorfeed X402 Base Mcp

Read-only Base mainnet chain reader for x402 payment verification. Confirms on-chain that a USDC settlement matches a claimed x402 receipt (recipient and amount), parses publisher /.well-known/x402 manifests, and lists recent USDC payments to an address. No private keys, verifica

#x402#base#usdc#payments#crypto#blockchain#onchain#agent-payments#verification

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

15

Returns the native ETH balance of an address on Base mainnet.

Returns the USDC balance of an address on Base mainnet (Circle native bridged USDC).

Returns the latest block number on Base mainnet.

Returns the receipt for a transaction on Base mainnet, including status, gas used, and a summary of emitted logs.

Performs an eth_call against a contract on Base mainnet. Read-only; never broadcasts a transaction.

Returns USDC Transfer events involving the given address over the last N blocks on Base mainnet. Direction filter: in, out, or both.

Given a tx hash, expected recipient, and expected USDC amount, returns a structured verdict on whether the on-chain USDC Transfer event actually matches the claimed settlement. Use to independently verify any x402 payment receipt.

Fetches https://{domain}/.well-known/x402.json (or x402) and returns the structured manifest. Used to discover what an x402-paid publisher accepts (scheme, network, payTo, prices, paid endpoints).

Returns USDC transfers TO the given address over the last N blocks on Base mainnet. A convenience wrapper for x402 merchants verifying incoming agent payments.

Performs a GET against an https URL and reports whether the response looks like a canonical x402-paid endpoint (HTTP 402 with a JSON body containing accepts[]). Read-only. Does not pay, does not broadcast.

Decodes a base64-encoded X-PAYMENT header payload per the Coinbase x402 V2 spec. Returns the parsed scheme, network, x402Version, EIP-3009 authorization, and signature. Pure offline decode; no signature is verified and no network call is made.

Calls TensorFeed's canonical AFTA certification endpoint for a domain. Returns a scored checklist of which Agent Fair-Trade Agreement tenets the domain's public surfaces satisfy. Read-only.

On-chain lookup: was this transaction hash a USDC payment to TensorFeed's canonical payment wallet (0x549c82e6bFC54bdaE9A2073744CBC2AF5D1FC6D1) on Base mainnet? Returns structured details if yes. For credit attribution and endpoint mapping, the paying agent should call https://tensorfeed.ai/api/payment/history with its bearer token.

Returns the latest x402 status snapshot for a given domain from TensorFeed's canonical hourly monitor: current outcome, latency, 24h/7d uptime, and the recent series of check results. Useful for agents picking which paid publisher to depend on.

Returns the canonical list of confirmed Agent Fair-Trade Agreement (AFTA) federation members as of this package version. Static curated list; chain through verify_afta_federation(domain) to confirm live cert posture per member.

Overview

What is Tensorfeed X402 Base Mcp?

A read-only MCP server for verifying x402 USDC settlements on Base mainnet. It lets any MCP-compatible agent independently audit x402 payment receipts on-chain, parse publisher .well-known/x402 manifests, and check AFTA federation status without private keys, signing, or broadcasts.

How to use Tensorfeed X402 Base Mcp?

Install globally via npm, then add the server to claude_desktop_config.json or use claude mcp add. Configure an optional private RPC URL via the TENSORFEED_RPC_URL environment variable for heavier workloads.

Key features of Tensorfeed X402 Base Mcp

  • Read-only chain visibility — no private keys, no signing
  • Generic Base tools: balance, usdc_balance, block_number, get_tx_receipt, call, recent_transfers
  • x402-native verification: verify_x402_settlement, parse_x402_manifest, probe_x402_endpoint
  • TensorFeed flavor tools: verify_afta_federation, tf_payment_lookup, x402_publisher_health, afta_federation_members
  • Input validators, output sanitization, 50 KB response cap, RPC allowlist
  • No telemetry, no phone-home, no analytics; MIT licensed

Use cases of Tensorfeed X402 Base Mcp

  • Verify an on-chain x402 settlement given a tx hash, recipient, and expected USDC amount
  • Fetch a publisher’s x402 manifest to understand which endpoints require payment and how
  • Probe any HTTPS URL to check if it returns canonical x402 paid 402 response
  • Audit USDC transfers to a merchant address over a recent block range
  • Check AFTA federation certification for a domain with scored checklist

FAQ from Tensorfeed X402 Base Mcp

How does this differ from Coinbase Base MCP?

Coinbase Base MCP is the transact-side server for proposing swaps, transfers, and x402 payments. This server is the verify-side — it independently confirms on-chain settlement after a payment has been made. They are complementary, not competing.

Does the server require a private key or wallet?

No. The server is read-only; it cannot move funds, sign, or broadcast transactions. It only checks on-chain data.

What RPC endpoint does it use, and can I bring my own?

It defaults to the public Base RPC (https://mainnet.base.org). For heavier workloads, set TENSORFEED_RPC_URL to an Alchemy or Infura URL that matches the allowlist in src/rpc/allowlist.ts.

Does the server phone home or collect telemetry?

No telemetry, no phone-home, no analytics. The server is stateless and only reads from the configured RPC.

How do I report a security issue?

Report security issues to [email protected]. Do not file a public issue or CVE for an unfixed vulnerability.

Frequently asked questions

How does this differ from Coinbase Base MCP?

Coinbase Base MCP is the transact-side server for proposing swaps, transfers, and x402 payments. This server is the verify-side — it independently confirms on-chain settlement after a payment has been made. They are complementary, not competing.

Does the server require a private key or wallet?

No. The server is read-only; it cannot move funds, sign, or broadcast transactions. It only checks on-chain data.

What RPC endpoint does it use, and can I bring my own?

It defaults to the public Base RPC (`https://mainnet.base.org`). For heavier workloads, set `TENSORFEED_RPC_URL` to an Alchemy or Infura URL that matches the allowlist in `src/rpc/allowlist.ts`.

Does the server phone home or collect telemetry?

No telemetry, no phone-home, no analytics. The server is stateless and only reads from the configured RPC.

How do I report a security issue?

Report security issues to **[email protected]**. Do not file a public issue or CVE for an unfixed vulnerability.

Comments

Basic information

Category

Other

Transports

stdio

Author

RipperMercs

Submitted by

RipperX

More Other MCP servers

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

ghidraMCP

LaurieWired

MCP Server for Ghidra

9.4K

Inbox Zero AI

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.