DopamineDesk x402 Marketplace MCP Server 是一个开源 MCP 买家适配器与市场客户端，让机器对机器的报告可以按请求付费，支付通过 Base 主网上的 x402 支付协议完成。它面向需要在一个工作流中即时购买一个当前答案的场景：没有 API 密钥、没有账户、没有订阅，仅在需要时用 USDC 购买一次当前结果。
用途 它把多个决策就绪的数据 API 打包成一个可通过 MCP 调用的市场，供现有代理在需要时按次购买。目录包含代理就绪审计、供应商入门风险、交易预检、实时 x402 机会研究、公司情报、端点验证、网站尽职调查、VIN 安全、市场检查、安全研究以及原子 EVM 读取。
主要能力 每个计费路由都接受 ?preview=true。预览是一份实时合约证明，展示来源、时效、所需输入和响应结构，但有意隐藏付费调用才会提供的决策就绪数值，因此买家可在付款前检查合约。
使用方式 从免费的 find_marketplace_products MCP 工具开始：用自然语言给出买家任务，它会返回三个排名实时产品以及一条 recommended_purchase，其中包含精确价格、所需输入，以及即用型预览和付费调用载荷。将示例输入替换为买家真实值，如可用则先预览，只有用户授权所列价格和支付方式后才执行付费调用。
该服务器可从任何兼容 stdio 的 MCP 客户端使用，官方 MCP 注册表名称为 io.github.jblaz6335/ai-data-marketplace。工具列表从生产 OpenAPI 文档构建，数量、价格、可用性、数据模式和来源声明均来自实时合约而非手写端点列表。
对于已有代理，设置 X402_TOOL_MODE=compact 可只暴露 find_marketplace_products 和 purchase_marketplace_product；所有实时产品仍可通过这两个工具获得。默认完整模式保留产品专用工具以支持现有集成。启动默认服务器不需要环境变量或钱包密钥；仅当买家选择本地签名自动支付时才需要钱包。远程 /mcp URL 是单独经过身份验证的发布者集成，不是公共 stdio 安装 URL。
examples/README.md 提供可直接复制的配置和免费端到端客户端检查，该检查会发现真实产品并请求其免费预览，但从不签名或提交支付。llms-install.md 提供自动化客户端安装说明，其默认配置暴露免费发现和预览，不收集钱包密钥或启用自动支付。
支付方式 每次计费产品都通过 Coinbase CDP facilitator 在 Base 主网上使用 x402 v2 exact 支付：调用端点并读取 base64 的 PAYMENT-REQUIRED 响应头；用兼容的 x402 买家客户端签署 exact 授权；用 PAYMENT-SIGNATURE 重试；从 PAYMENT-RESPONSE 读取结算详情。PAYMENT_FLOW.md 记录了手动和旧版已确认交易路径。
可选的一次调用购买：当前 npm 发布版可自动完成 x402 挑战、授权、重试和结算。直接安装公共包，买家密钥留在本地 MCP 进程内，绝不发送到市场；应使用专用的低余额 Base 钱包而非主钱包。调用产品时设置 auto_pay: true，适配器会拒绝已禁用、冲突、无效或超过上限的购买，绝不回退到无上限支付。
也可不配置钱包而使用积分购买：该服务已被 APIHub 的外部 x402 目录收录，拥有 APIHub 积分的买家可让其代理签署并结算一次市场调用，而无需在调用进程中保留 Base 钱包或 gas。APIHub 是独立第三方，有自己的账户、积分、加价和条款。直接 x402 仍是自托管路径。两条路径都会在交付付费结果前结算受保护端点。
适用场景与限制 适用于需要按次获取决策就绪报告的 MCP 代理工作流，尤其是交易预检、公司情报、端点验证、VIN 安全和市场检查等。限制与注意事项包括：自动购买为可选、本地签名，并受每次调用硬上限保护；冲突、畸形、已禁用和超过上限的支付尝试会失败关闭；结算详情保留在交付结果中以便对账。使用自动支付时应使用专用低余额钱包。生产合约、OpenAPI、Postman、LLM manifest、x402 manifest 等位于 ai-data-marketplace-1042299154756.us-central1.run.app 下对应路径。项目采用 MIT 许可证。
