x402-bazaar-mcp

x402-bazaar-mcp

**托管服务，无需安装：**让任意 MCP 客户端连接到 https://402.com.tr/mcp — Streamable HTTP，每个已编入目录的服务对应一个工具，服务端不持有钱包。也可以按下文所述使用 npx 在本地运行；两种方式都连接到同一个目录。当前工具列表始终以服务卡片为准；此处写下的数量在下次添加服务时就会过时。

面向 AI Agent 的 Base 代币安全工具包。一个MCP（Model Context Protocol）服务，为 Agent 提供触碰 Base 代币前所需的检查——包括一套涵盖冻结／没收权限、策略变更、铸币余量和 rebase 历史的 30 个工具 B20（Base 原生代币标准）套件；该套件还覆盖 Coinbase 的全部 82 种代币化股票，通过读取链上转账策略的管理者，而不是查询地址列表，区分真实发行资产与仅仅使用股票代码的代币，因此新发行的资产一出现就能被识别——还包括交易前 GO/HOLD/STOP 门控、蜜罐与可卖出性检查、钱包与授权审计、签名防护、价格和 AI 报告。x402 Bazaar 目录中的每个付费 API 都会作为可调用工具提供（适用于 Cursor、Cline、Windsurf、VS Code、Coinbase AgentKit、桌面助手和自定义 Agent）。

优先绑定这些工具：pre_trade_gate（任意 Base 代币）、near_pre_trade_gate（NEAR 代币）、b20_gate（Base 原生 B20 代币）、sign_guard（签署交易前）。

然后再行动——检查之后，以最佳价格兑换：

• base_swap — 在 Base 上通过 0x 路由，覆盖 Uniswap、Aerodrome、Balancer、Curve 等。返回路由、最低输出量、所有费用，以及可供 Agent 自己的钱包签名的交易。购买未知代币时会先检查其可卖出性，并拒绝蜜罐。
• near_swap — 通过 NEAR Intents 跨链兑换（NEAR、Base、Ethereum、Solana、Bitcoin……）。返回一次性存款地址；输出会发送给你的收款方，或退款。购买 NEAR 代币时会先运行 near_token_safety。使用 near_swap_status 跟踪兑换状态。

资金绝不会经过此服务或我们的服务。

无需钱包即可开始。无需密钥、代币或任何配置即可运行，并使用免费层级——每个提供免费额度的服务每天可免费调用一次。大约三分之一的目录服务不提供免费额度：AI 和按量计费的服务始终收费，目录中的每个条目都会在 freeTier 下说明是否提供免费额度。用量超出后，预付额度代币可让你继续免钱包使用：购买一次，之后每次调用只需添加一个 HTTP 标头。只有第三种模式——按次付费——才需要钱包。

除此之外，每次工具调用都通过 Base 上以 USDC 支付的 x402 微支付提供支持——无需 API 密钥、订阅或注册。Agent 只需为实际使用的服务付费，每次调用通常只需几分之一美分。

零配置即可使用。无需钱包或代币即可运行，并使用免费层级（每个提供免费额度的服务每天可免费调用一次，之后可预览）——因此 Agent 可以立即试用目录中的大多数服务，并且在 AI 和按量计费工具上会看到明确的 402 价格，而不会遭遇意外收费。若要解锁不限量的付费调用，可选择预付额度代币（预先进行一次 x402 购买，之后每次调用都无需钱包或签名）或钱包密钥。

---

工作原理

1. 启动时，服务会从 https://402.com.tr/api/catalog 获取实时目录，并自动为每项服务注册一个 MCP 工具。
2. AI Agent 调用工具时，服务会选择一种支付模式（见下文）、访问端点并返回响应。
3. 钱包模式下，x402 流程透明可见： HTTP 402 → 在 Base 上支付 USDC → 重试 → 返回响应，付款方无需支付 Gas（由 facilitator 支付 Gas）。

三种支付模式（优先级顺序）

模式	设置项	处理方式	钱包？签名？
Credits ⭐	X402_CREDIT_TOKEN	以 x-credit-token 发送；每次调用都会扣减预付余额	否 / 否
Wallet	AGENT_PRIVATE_KEY	每次调用时在本地签署 x402 USDC 支付	是 / 是
Free	（无）	免费层级：每个服务每天可完整调用 1 次，之后提供预览	否 / 否

Credits 是日常使用中最简单的付费模式：购买套餐只需完成一次 x402 结算（在钱包模式下调用 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 钱包私钥，且该钱包地址在 Base 主网上持有 USDC

---

安装与运行

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 的请求签名，并以 Base 上的 USDC 向 Bazaar 自有地址付款，金额不超过 X402_MAX_PRICE_USD。这些配置在软件包中固定（或由这些环境变量设置）——不会从目录或 402 响应中读取，因此，任何指向其他地址的目录条目或 402 响应都会按未付款处理。

环境变量

变量	必需	默认值	说明
X402_CREDIT_TOKEN	否	—	来自 buy-credits 的预付信用令牌（ck_…）。以 x-credit-token 发送；每次调用都会扣减余额。无需钱包。推荐的付费模式。
AGENT_PRIVATE_KEY	否	—	持有 USDC 的 Base 钱包十六进制私钥。可省略 0x 前缀。仅在未设置信用令牌时使用。
X402_MAX_PRICE_USD	否	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 Agent 配合使用

由于这是一个标准的 MCP stdio 服务，任何支持 MCP 的 Agent 运行时都可以加载 Bazaar 的工具并为其付款——包括 Coinbase 自家的 Agent 技术栈，无需专门集成：

Coinbase Agentic Wallet（npx awal）

Coinbase Agentic Wallets 原生支持 x402，并提供 MCP 接口。将钱包的 MCP 配置指向 npx x402-bazaar-mcp，Agent 就能直接通过其 MPC 安全钱包调用任意 Bazaar 服务并为其付款，在 Base 上无需 Gas。x402 付款握手由系统为你处理：HTTP 402 → pay USDC on Base → retry → response。

Coinbase AgentKit

有两种接入方式：

1. 作为 MCP 工具 — 将此服务加载到 AgentKit Agent 的 MCP 配置中 （设置 command: "npx"、args: ["-y", "x402-bazaar-mcp"]，并在 env 中设置 X402_CREDIT_TOKEN 或 AGENT_PRIVATE_KEY）。Agent 即可使用所有 Bazaar 工具 — B20 冻结/没收检查、交易前检查、蜜罐/可售性检查、部署者信誉、退出流动性、实时 DEX 价格、Gas、交易解码、AI 报告 — 作为按次付费的操作，无需编写操作提供程序。
2. 通过 AgentKit 的原生 x402 支持 — AgentKit 钱包可以直接结算 x402 付款，因此 Agent 可以 GET https://402.com.tr/api/x402/<service> 并通过自己的钱包支付返回的 402。402 响应正文包含机器可读的 alternatives 区块（优先提供入门额度），让 Agent 可以通过程序选择最便宜的接入方式。

无论采用哪种方式，Agent 都只需为实际调用付费，以 USDC 在 Base 上付款，无需 Gas。

命令行 Agent

通过 mcp add 命令管理 MCP 服务的 CLI Agent 使用同一服务：

# 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

然后让 Agent 检查代币、为投资组合估价或筛查地址 — 它会调用相应的 Bazaar 工具并自动结算小额付款。

---

Agent 为什么会使用它

Agent 需要最新的链上数据和 AI 实用工具，但不想管理 RPC 端点、抓取程序、安全启发式规则或各提供方的 API 密钥。一个 MCP 服务加上一个额度令牌（或已注资的钱包），就能提供所需的一切 — 合约安全检查、实时 DEX 价格、Gas 估算、交易解码和 AI 驱动的报告 — 全部按使用量付费，无需订阅或注册。

---

你的 Agent 可以做什么（工具）

工具会从目录实时加载，因此列表始终保持最新。撰写本文时，目录包含：

工具	价格	功能
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	一次调用获取最多 10 种 Base 代币的价格
address_intel	$0.02	任意地址的 EOA/合约、ETH+USDC 余额和活动
wallet_tokens	$0.02	主要 Base 代币的投资组合 + USD 价值
gas_oracle	$0.01	实时 Base Gas 费用估算（慢速/普通/快速）
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 编写以来新增的任何内容。

示例

安装完成后，只需用自然语言向你的 Agent 提问——它会选择合适的工具，并按调用付费：

“0x… 是可以在 Base 上购买的安全代币吗？检查风险和当前价格。”

Agent 会调用 token_risk 和 token_price，每次都从你的钱包结算一笔小额 USDC 付款，并根据链上数据作答。

“Base 上这个 NVDA 代币是真正的 Coinbase 代币吗？”

b20_safety 会直接根据链上信息作答，而非查询列表：它会读取谁管理该代币的转账策略，并报告该管理者是否为 Coinbase 已确认发行的代币背后的运营方。仿冒者可以复制代号、名称，甚至 0xb200… 这种靓号地址；但无法冒用策略管理者。相同的答案还会说明发行方所拥有的权限——持有者资格门控、受限铸造，以及可一次性重新设定所有余额面额的 rebasing 乘数——这些都是受监管金融工具的事实，而非值得引发恐慌的风险评分。

---

示例输出

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

---

安全说明

预付费额度（推荐）可避免在 Agent 配置中存放钱包信息——购买额度包只需进行一次 x402 结算；之后 Agent 持有的只有 ck_… 令牌：一种价值仅限于剩余额度的持有者凭证，因此即使令牌泄露，损失也最多只是其中的剩余额度，绝不会涉及钱包。购买小额额度包，并在需要时轮换令牌。

如果你改用钱包模式，私钥仅会在此进程内本地用于签署付款授权，绝不会发送到 Bazaar 服务或任何第三方。请使用专用的支出钱包（而非主钱包），并仅在其中保留少量 USDC。

---

许可证

MIT