x402-bazaar-mcp

x402-bazaar-mcp

ホスト型、インストール不要： 任意の MCP クライアントから https://402.com.tr/mcp に接続できます — Streamable HTTP に対応し、カタログに掲載されたサービスごとに 1 つのツールを提供します。サーバー側でウォレットを保持することはありません。または、以下の説明に従って npx でローカル実行することもできます。どちらも同じカタログを利用します。現在のツール一覧は常に サーバーカードで確認できます。ここに数を記載すると、サービスが追加された時点で誤った情報になります。

AI エージェント向けの Base トークン安全性ツールキットです。 エージェントが Base トークンを扱う前に必要なチェックを提供する MCP（Model Context Protocol）サーバーです。凍結・差し押さえ権限、ポリシー変更、ミント余力、リベース履歴を網羅する 30 ツールの B20（Base ネイティブトークン標準）スイートも含まれています。また、Coinbase のトークン化株式 82 銘柄すべてにも対応しています。アドレスの一覧を参照するのではなく、オンチェーンで送金ポリシーを管理している主体を確認することで、実際の発行と、株式ティッカーを名乗るだけのトークンを見分けます。そのため、新たに発行された銘柄も、登場したその日に認識されます。ほかにも、取引前の GO/HOLD/STOP 判定、ハニーポットおよび売却可能性チェック、ウォレットと承認の監査、署名ガード、価格、AI レポートを提供します。x402 Bazaar カタログ内のすべての有料 API を呼び出し可能なツールとして利用できます（Cursor、Cline、Windsurf、VS Code、Coinbase AgentKit、デスクトップアシスタント、カスタムエージェントに対応）。

まず、以下をバインドしてください： pre_trade_gate（任意の Base トークン）、near_pre_trade_gate（NEAR トークン）、b20_gate（Base ネイティブの B20 トークン）、sign_guard（トランザクションへの署名前）。

その後、チェックを済ませて最良価格でスワップします：

• base_swap — Base 上で、0x が Uniswap、Aerodrome、Balancer、Curve などを経由してルーティングします。ルート、最小受取数量、すべての手数料、およびエージェント自身のウォレットで署名できるトランザクションを返します。未知のトークンを購入する場合は、まず売却可能性をチェックし、ハニーポットであれば拒否します。
• near_swap — NEAR Intents を介して、チェーン間（NEAR、Base、Ethereum、Solana、Bitcoin など）でスワップします。1 回限りの入金アドレスを返し、出力は指定した受取先に送られるか、返金されます。NEAR トークンを購入する場合は、まず near_token_safety を実行します。near_swap_status で進捗を追跡できます。

資金がこのサーバーや当社のサーバーを経由することはありません。

開始時にウォレットは不要です。 キー、トークン、設定が何もない状態で実行すると、無料枠が使用されます。無料枠を提供する各サービスで、1 日 1 回無料で呼び出せます。カタログのおよそ 3 分の 1 は無料枠を提供していません。AI サービスと従量制サービスは常に有料です。カタログの各項目には、freeTier の下に無料枠の有無が記載されています。無料枠では足りなくなった場合は、前払いクレジットトークンを使えばウォレット不要のまま利用できます。1 回購入すれば、その後の各呼び出しは HTTP ヘッダーを送るだけです。ウォレットが必要なのは、3 つ目のモードである呼び出しごとの支払いだけです。

それ以外の各ツール呼び出しは、Base 上の USDC による x402 マイクロペイメントで処理されます。API キー、サブスクリプション、サインアップは不要です。エージェントは利用した分だけ支払います。通常、1 回あたり 1 セント未満です。

設定なしですぐに使えます。 ウォレットもトークンもない状態で実行すると、無料枠（無料枠を提供する各サービスで 1 日 1 回無料、その後はプレビュー）が適用されます。エージェントはカタログの大半をすぐに試すことができ、AI ツールや従量制ツールでは、予期せぬ課金ではなく、価格が提示された 402 を確認できます。前払いクレジットトークン（x402 で事前に 1 回購入し、その後は呼び出しごとのウォレットも署名も不要）またはウォレットキーを使うと、有料呼び出しを無制限に利用できます。

---

仕組み

1. 起動時にサーバーはライブカタログを https://402.com.tr/api/catalog から取得し、サービスごとに 1 つの MCP ツールを自動登録します。
2. AI エージェントがツールを呼び出すと、サーバーは支払いモード（以下を参照）を選び、エンドポイントにリクエストを送り、応答を返します。
3. ウォレットモードでは、x402 のフローは透過的です： HTTP 402 → pay USDC on Base → retry → return response。支払者にガス代はかかりません（ガス代はファシリテーターが支払います）。

3 つの支払いモード（優先順位順）

モード	設定	動作	ウォレット？ 署名？
クレジット ⭐	X402_CREDIT_TOKEN	x-credit-token として送信されます。呼び出しごとにプリペイド残高から差し引かれます	いいえ / いいえ
ウォレット	AGENT_PRIVATE_KEY	呼び出しごとにローカルで x402 USDC 支払いに署名します	はい / はい
無料	(なし)	無料枠：サービスごとに 1 日 1 回、完全な呼び出しができ、その後はプレビューになります	いいえ / いいえ

クレジットは、日常的に使う有料モードとして最も手軽です。パックの購入時に必要なのは x402 の決済 1 回だけです（ウォレットモードで buy_credits ツールを呼び出すか、任意の x402 クライアントから https://402.com.tr/api/x402/buy-credits?tier=0.25|1|5|20 に支払います）。購入すると ck_… トークンが返されます。これを X402_CREDIT_TOKEN に設定すれば、その後の呼び出しでは残高が差し引かれるだけです。この設定で秘密鍵が使われることはありません。ティア：$0.25 のスターター、$1、$5（+10%）、$20（+20%）。

NEAR から支払いますか？ 同じクレジットトークンは、NEAR 上で USDC、USDT、または NEAR（あるいは NEAR Intents がルーティングする任意の資産）を使って購入できます。ブラウザーで 402.com.tr/credits にアクセスするか、ヘッドレスで POST https://402.com.tr/api/credits/near/quote を実行してください。NEAR Intents が Base 上の USDC に交換するため、Base ウォレットは不要です。

---

必要条件

• Node.js ≥ 20
• (任意、有料の呼び出しに必要) プリペイドクレジットトークン または Base メインネット上に USDC を保有する Base ウォレットの秘密鍵

---

インストールと実行

npm install

# Zero-config — free tier on every service that offers one:
npx x402-bazaar-mcp

# Paid via prepaid credits (recommended — no wallet, no signing):
X402_CREDIT_TOKEN=ck_your_token npx x402-bazaar-mcp

# Paid via wallet:
AGENT_PRIVATE_KEY=0xYOUR_PRIVATE_KEY npx x402-bazaar-mcp

ウォレットモードでは、キーは https://402.com.tr へのリクエストに対してのみ署名し、Bazaar 自身のアドレスに Base 上の USDC で支払います。支払額は X402_MAX_PRICE_USD 以下です。これらはパッケージ内で固定されている（または該当する環境変数で設定される）ため、カタログや 402 から取得されることはありません。したがって、別の宛先を指すカタログ項目や 402 への呼び出しは、支払いなしで行われます。

環境変数

変数	必須	デフォルト	説明
X402_CREDIT_TOKEN	いいえ	—	buy-credits で取得するプリペイドクレジットトークン（ck_…）。x-credit-token として送信され、呼び出しごとに残高から差し引かれます。ウォレットは不要です。推奨の有料モードです。
AGENT_PRIVATE_KEY	いいえ	—	USDC を保有する Base ウォレットの 16 進数形式の秘密鍵。0x プレフィックスは省略できます。クレジットトークンが設定されていない場合にのみ使用されます。
X402_MAX_PRICE_USD	いいえ	1	ウォレットモード：1 回の呼び出しで支払える上限額です。402 の要求額がこれを超える場合、署名されません。ウォレットからより大きなクレジットパックを購入する場合は、意図的に値を引き上げてください。
X402_PAY_ORIGIN / X402_PAY_TO	いいえ	https://402.com.tr / Bazaar の支払い先アドレス	ウォレットモード：ウォレットが支払う唯一のオリジンと、唯一の支払い先アドレスです。
X402_BAZAAR_CATALOG	いいえ	https://402.com.tr/api/catalog	カタログ URL を上書きします（ローカル開発に便利です）。

上記を何も設定しない場合、サーバーは無料枠で動作します。

---

デスクトップ MCP クライアント

ほとんどのデスクトップアシスタントと IDE は、MCP 設定ファイルから mcpServers ブロックを読み込みます（場所については、お使いのクライアントのドキュメントを参照してください）。次を追加します。

{
  "mcpServers": {
    "x402-bazaar": {
      "command": "npx",
      "args": ["-y", "x402-bazaar-mcp"],
      "env": {
        "X402_CREDIT_TOKEN": "ck_your_token"
      }
    }
  }
}

無料枠で実行するには env ブロックを完全に省略します（まず試すのに最適です）。ウォレットから支払うには、クレジットトークンの代わりに "AGENT_PRIVATE_KEY": "0x…" を使用してください。

保存後にクライアントを再起動すると、Bazaar のツールがツール一覧に表示されます。

---

Cursor

~/.cursor/mcp.json（グローバル）またはプロジェクト内の .cursor/mcp.json に追加します。

{
  "mcpServers": {
    "x402-bazaar": {
      "command": "npx",
      "args": ["-y", "x402-bazaar-mcp"],
      "env": { "X402_CREDIT_TOKEN": "ck_your_token" }
    }
  }
}

Cline（VS Code）

Cline パネルで → MCP Servers → Configure（cline_mcp_settings.json）を開きます。

{
  "mcpServers": {
    "x402-bazaar": {
      "command": "npx",
      "args": ["-y", "x402-bazaar-mcp"],
      "env": { "X402_CREDIT_TOKEN": "ck_your_token" },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json に追加します。

{
  "mcpServers": {
    "x402-bazaar": {
      "command": "npx",
      "args": ["-y", "x402-bazaar-mcp"],
      "env": { "X402_CREDIT_TOKEN": "ck_your_token" }
    }
  }
}

VS Code（GitHub Copilot / MCP）

ワークスペースの .vscode/mcp.json に追加するか、MCP: Add Server を実行します。

{
  "servers": {
    "x402-bazaar": {
      "command": "npx",
      "args": ["-y", "x402-bazaar-mcp"],
      "env": { "X402_CREDIT_TOKEN": "ck_your_token" }
    }
  }
}

上記のすべてのクライアントで同じように動作します。無料枠で実行するには env を省略し、ウォレットから支払うにはクレジットトークンを "AGENT_PRIVATE_KEY": "0x…" に置き換えてください。

---

Coinbase AgentKit、Agentic Wallet、CLI エージェントでの使用

これは標準的な MCP stdio サーバーなので、Coinbase 独自のエージェントスタックを含め、MCP 対応のランタイムであればどれでも Bazaar のツールを読み込んで支払いを行えます。専用の統合は必要ありません。

Coinbase Agentic Wallet（npx awal）

Coinbase の Agentic Wallets は、ネイティブの x402 サポートと MCP インターフェースを備えています。ウォレットの MCP 設定で npx x402-bazaar-mcp を指定すると、エージェントは MPC で保護されたウォレットから、Base 上でガス代不要で、Bazaar のあらゆるサービスを呼び出して支払いまで行えます。x402 の支払いハンドシェイクは自動で処理されます：HTTP 402 → pay USDC on Base → retry → response。

Coinbase AgentKit

利用方法は次の 2 通りです。

1. MCP ツールとして — このサーバーを AgentKit エージェントの MCP 設定に読み込みます（command: "npx"、args: ["-y", "x402-bazaar-mcp"] を指定し、env に X402_CREDIT_TOKEN または AGENT_PRIVATE_KEY を設定します）。エージェントは、B20 の凍結／差し押さえチェック、取引前のゲート、ハニーポット／売却可能性、デプロイヤーの評判、出口流動性、DEX のリアルタイム価格、ガス代、トランザクションのデコード、AI レポートなど、あらゆる Bazaar ツールを従量課金のアクションとして利用できます。アクションプロバイダーを作成する必要はありません。
2. AgentKit のネイティブ x402 サポート経由 — AgentKit のウォレットは x402 の支払いを直接決済できるため、エージェントは GET https://402.com.tr/api/x402/<service> を実行し、返された 402 に自身のウォレットから支払えます。402 の本文には、最初にスタータークレジットを提示する機械可読な alternatives ブロックが含まれているため、エージェントはプログラムによって最も安価なオンランプを選択できます。

どちらの方法でも、エージェントは実行した呼び出し分のみを、Base 上で USDC により、ガス代不要で支払います。

コマンドラインエージェント

mcp add コマンドで MCP サーバーを管理する CLI エージェントは、同じサーバーを利用します。

# Free tier (zero config):
<agent-cli> mcp add x402-bazaar -- npx -y x402-bazaar-mcp

# Or paid via prepaid credits:
<agent-cli> mcp add x402-bazaar -e X402_CREDIT_TOKEN=ck_your_token -- npx -y x402-bazaar-mcp

その後、トークンの確認、ポートフォリオの価格算出、アドレスのスクリーニングをエージェントに依頼すると、適切な Bazaar ツールを呼び出し、マイクロペイメントを自動的に決済します。

---

エージェントがこれを利用する理由

エージェントには最新のオンチェーンデータや AI ユーティリティが必要ですが、RPC エンドポイント、スクレーパー、セキュリティ上の判定基準、プロバイダーごとの API キーを管理したくはありません。1 つの MCP サーバーとクレジットトークン（または資金を入金したウォレット）があれば、コントラクトの安全性チェック、DEX のリアルタイム価格、ガス代の見積もり、トランザクションのデコード、AI を活用したレポートなど、すべてを利用できます。サブスクリプションも登録も不要で、利用した分だけ支払えます。

---

エージェントができること（ツール）

ツールはカタログからリアルタイムに読み込まれるため、リストは常に最新の状態に保たれます。執筆時点では、以下が含まれています。

ツール	価格	機能
pre_trade_gate	$0.10	取引前のワンコール — リスク＋売却可能性＋ルート＋デプロイヤーを確認し、GO/HOLD/STOPを判定
token_risk	$0.03	あらゆるBaseトークンの安全性スコア（ハニーポット、税、所有権、保有者）
sellability	$0.08	実際に売却できるかを判定。ハニーポット／税／LPシミュレーションによる評価
ai_token_report	$0.12	トークンのAI作成による包括的なデューデリジェンスレポート
sanctions	$0.02	OFAC制裁リストに照らしてアドレスを審査
holders	$0.02	トークンの上位保有者、集中度（クジラリスク）、LPロック状況
token_price	$0.02	BaseトークンのDEX価格＋流動性
multi_price	$0.02	1回の呼び出しで最大10個のBaseトークンの価格を取得
address_intel	$0.02	あらゆるアドレスのEOA／コントラクト、ETH＋USDC残高、アクティビティ
wallet_tokens	$0.02	Baseの主要トークンのポートフォリオ＋米ドル換算額
gas_oracle	$0.01	Baseのリアルタイムのガス見積もり（低速／通常／高速）
tx_decode	$0.02	Baseトランザクションの構造的なデコード
contract_abi	$0.02	コントラクトが検証済みかを確認し、ABIを取得（Sourcify）
basename	$0.01	Base上でBasenameとアドレスを相互に解決
trending_tokens / new_tokens	$0.01	Baseでトレンド中のトークンと新規上場トークン
price_alert	$0.05	トークン価格が指定価格を超えたときのアラートを登録（Webhookまたはポーリング）
buy_credits	$0.25–$20	プリペイドクレジットパックを購入（tierパラメーター）— ウォレット不要の呼び出しを利用可能にします

価格はこのリリース時点のものです。正式な価格は常にライブカタログと各402チャレンジで確認してください。上の表は一例です。起動時にツールリストがカタログからリアルタイムに読み込まれるため、サーバーはマーケットプレイスで現在販売されているすべてのサービスを公開します。これにはB20安全性スイート、ウェブおよびビジネス関連のチェック（url_extract、email_verify、domain_check）、そしてこのREADMEの執筆以降に追加されたものも含まれます。

例

インストール後は、エージェントに自然な言葉で尋ねるだけです。エージェントが適切なツールを選び、呼び出しごとに支払います。

「0x…はBaseで購入しても安全なトークンですか？リスクと現在の価格を確認してください。」

エージェントはtoken_riskとtoken_priceを呼び出し、それぞれの呼び出しでウォレットから少額のUSDCを決済し、オンチェーンデータに基づいて回答します。

「Base上のこのNVDAトークンは、本物のCoinbaseのものですか？」

b20_safetyはリストではなくチェーンから回答します。トークンの移転ポリシーを誰が管理しているかを読み取り、その管理者がCoinbaseの確認済み発行を担う運営者のものかどうかを報告します。類似トークンはティッカーや名前、さらには0xb200…のような見栄えのよいアドレスまでコピーできます。しかし、ポリシー管理者を借りることはできません。同じ回答には、発行者の権限、つまり保有者適格性のゲート、ゲート付きミント、すべての残高を一度に改定するリベース倍率も含まれます。これらは警戒を促すリスクスコアではなく、規制対象の金融商品に関する事実として示されます。

---

出力例

token_risk — 低リスクのトークン

{
  "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "isContract": true,
  "token": {
    "name": "USD Coin",
    "symbol": "USDC",
    "decimals": 6,
    "totalSupply": "4800000000000000"
  },
  "ownership": {
    "owner": "0x0000000000000000000000000000000000000000",
    "renounced": true
  },
  "upgradeableProxy": false,
  "security": {
    "isHoneypot": false,
    "buyTaxPct": 0,
    "sellTaxPct": 0,
    "isOpenSource": true,
    "isMintable": false,
    "transferPausable": false,
    "canTakeBackOwnership": false,
    "hiddenOwner": false,
    "holderCount": 182430,
    "topHolderPct": 12.47,
    "top10HolderPct": 41.22,
    "lockedLpPct": 100,
    "creatorPct": 0,
    "isInDex": true,
    "isAntiWhale": false,
    "antiWhaleModifiable": false,
    "tradingCooldown": false,
    "slippageModifiable": false,
    "isTrueToken": true,
    "isAirdropScam": false,
    "creatorAddress": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
    "creatorBalance": "0"
  },
  "riskScore": 0,
  "riskLevel": "low",
  "flags": [],
  "sources": ["base-rpc", "goplus"],
  "coverage": "RPC base + GoPlus security (honeypot, taxes, holders, holder concentration, LP lock, creator holdings, source, ownership controls).",
  "checkedAt": "2026-06-23T09:14:02.381Z"
}

token_price — DEXの価格と流動性

{
  "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "priceUsd": "0.9998",
  "priceChange24h": -0.03,
  "liquidityUsd": 4721850.44,
  "volume24h": 18340210.77,
  "dexId": "uniswap",
  "pairAddress": "0x88A43bbDF9D098eEC7bCEda4e2494615dfD9bB9C",
  "baseToken": {
    "name": "USD Coin",
    "symbol": "USDC"
  },
  "checkedAt": "2026-06-23T09:14:03.105Z"
}

---

利用可能なサービスの確認

• 人が読みやすいカタログとドキュメント：https://402.com.tr/agents
• 機械可読カタログ（このサーバーが使用）：https://402.com.tr/api/catalog
• x402 well-known：https://402.com.tr/.well-known/x402

---

セキュリティに関する注意

プリペイドクレジット（推奨）を使えば、エージェント設定にウォレットを含めずに済みます。パックの購入時にはx402決済が1回必要ですが、その後エージェントが保持するのはck_…トークンだけです。このトークンは残高分の価値しかないベアラー機能なので、漏えいしても失われるのは残高の範囲内に限られ、ウォレットが失われることはありません。少額のパックを購入し、必要に応じてローテーションしてください。

ウォレットモードを使用する場合、秘密鍵は支払い承認への署名のため、このプロセス内でローカルにのみ使用されます。Bazaarサーバーやその他の第三者に送信されることはありません。専用の支払い用ウォレット（メインウォレットではないもの）を使用し、USDC残高は少額にとどめてください。

---

ライセンス

MIT