Tensorfeed X402 Base MCP Server

@RipperMercs

代码仓库

基本信息

分类

其他

传输方式

stdio

作者

RipperMercs

提交者

RipperX

关于 Tensorfeed X402 Base MCP Server

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

Tensorfeed X402 Base MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

Tensorfeed X402 Base MCP Server 工具

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.

概览

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

常见问题

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 **security@tensorfeed.ai**. Do not file a public issue or CVE for an unfixed vulnerability.

其他分类下的更多 MCP 服务器

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.