basezap-mcp

An MCP (Model Context Protocol) server that exposes BaseZap's tipping-agent tools to any MCP client — Claude Desktop, Cursor, Claude Code, etc.

This server is read-only / non-custodial by design: it never holds private keys, never signs anything, and never broadcasts a transaction. It only fetches platform info, computes fee quotes, and builds unsigned ERC-20 transfer calldata for a separate wallet-connected client to sign and send.

Tools

• get_platform_info — チェーン、USDCアドレス、プラットフォーム手数料（bps）、手数料ウォレット。

• get_tip_quote — USDC金額を指定すると、正確なクリエイター/プラットフォーム手数料の分割を返します。

• build_tip_calldata — 受取人アドレスと金額を指定すると、チップの両方のレッグに対する未署名のcalldataを返します。署名や送信は一切行いません。

• resolve_farcaster_username — Farcasterユーザー名を解決して、その検証済みウォレットアドレスを取得します（BaseZapの/api/resolve-userエンドポイントを直接使用）。

Related MCP server: x402-bazaar-mcp

Install

npm install --ignore-scripts
npm run build

（--ignore-scriptsは一部の環境（例：Termux/Android）でのネイティブモジュールビルドの問題を回避します。どこでも安全に使用できます。）

Running standalone (for testing)

npm start

または、MCPクライアントなしでstdio経由で単一のツール呼び出しを直接テストする：

echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_tip_quote","arguments":{"amountUsdc":1}}}' | node build/index.js

Claude Desktop config

これをclaude_desktop_config.jsonに追加します（設定 → 開発者 → 設定を編集）：

{
  "mcpServers": {
    "basezap": {
      "command": "node",
      "args": ["/absolute/path/to/basezap-mcp/build/index.js"],
      "env": {
        "BASEZAP_USE_X402": "false"
      }
    }
  }
}

パスを実際のマシン上のbuild/index.jsの絶対パスに置き換えてください。設定編集後、Claude Desktopを再起動してください。

Free vs. paid (x402) mode

デフォルト（BASEZAP_USE_X402=falseまたは未設定）では、サーバーはBaseZapの無料エンドポイント（/api/agent）を呼び出します。BASEZAP_USE_X402=trueに設定すると、代わりに有料のx402エンドポイント（1回の呼び出しにつき$0.001 USDC）を経由するようになります。

重要：BASEZAP_USE_X402=trueを設定するだけでは、サーバーが自動的に支払うようにはなりません。別途自動支払いを設定するか（下記参照）、すでにx402支払いを処理するMCPクライアント/ゲートウェイを使用していない限り、呼び出しごとに明確なHTTP 402 Payment Requiredエラーが発生します。

Optional: x402 auto-pay

資金が入ったウォレットを使用してこのサーバーが自身のx402手数料を自動的に支払うようにするためのゼロからのガイドはAUTOPAY.mdを参照してください。使用する前に注意深く読んでください。実際の秘密鍵を環境変数に入れる必要があり、設定を誤った自動支払いサーバーはすべてのツール呼び出しで静かに実際のお金を消費する可能性があります。デフォルトでは有効になっておらず、有効にする前にその動作を正確に理解する必要があります。

Verified request contract

このサーバーが依存する正確なリクエスト/レスポンスの形状は、実際の/api/agentエンドポイントに対してライブで確認されました（ドキュメントから推測したものではありません）。

{ "tool": "get_tip_quote", "args": { "amount_usdc": 1 } }

は以下を返します：

{ "total_usdc": 1, "creator_receives_usdc": 0.95, "platform_fee_usdc": 0.05, "platform_fee_bps": 500 }

API自体はargs内でsnake_caseのフィールド名を使用していることに注意してください。このサーバーのMCPツール入力は親しみやすいcamelCase（amountUsdc）を使用し、内部で変換するため、これはサーバー自体を変更する場合にのみ関連します。