DopamineDesk x402 Marketplace

DopamineDesk x402 市场 MCP 服务

通过 Base Mainnet 上的 x402 Payment Protocol，按请求付费获取可直接用于决策的机器对机器报告。

无需 API 密钥、无需账户、无需订阅。 工作流需要时，使用 USDC 购买一份最新答案。目录包含 Agent 就绪度审计、供应商入驻风险、交易预检、实时 x402 机会研究、公司情报、端点验证、网站尽职调查、VIN 安全、市场检查、安全研究和原子 EVM 读取。

每个计费路由都支持 ?preview=true。预览是一份实时合约证明，展示来源、新鲜度、所需输入和响应格式，但会刻意隐藏付费调用提供的、可直接用于决策的数据。

从免费的 find_marketplace_products MCP 工具开始。用通俗语言描述买家的任务，它会返回 3 个按排名排列的实时产品，以及一个 recommended_purchase，其中包含确切价格、所需输入，以及可直接使用的预览和付费调用载荷。将示例输入替换为买家的真实数据，在可用时先进行预览，并且只有在用户授权所列价格和付款方式后，才使用付费调用。

无需钱包即可试用

打开实时 Shopify 目录预览。它会运行公开数据源并展示响应格式；完整目录结果仍受 0.01 USDC 的付费门槛保护。预览无需账户、密钥或付款。

要在现有客户端中试用 MCP 适配器，复制双工具配置，并向你的 Agent 提问：“找一个检查公开 Shopify 店面的工具。告诉我价格和免费预览；不要付款。”精简模式通过两个工具提供完整目录。免费集成检查展示了从发现到预览的完整流程。

该商店公布实时去重结算总额，并将外部付款与所有者控制的测试分开统计。付费 API 调用可以证明商店的使用情况，但不代表独立用户数量，也不能证明每位买家都安装了此 MCP 包。npm 下载量也包含自动安装。

工程概览

此仓库包含开源 MCP 买家适配器和客户端。市场后端是一个独立服务。

flowchart LR
    A[MCP client] --> B[Local adapter]
    B --> C[OpenAPI discovery and free previews]
    B --> D[Opt-in capped payment]
    D --> E[Marketplace endpoint]
    E --> F[Result and settlement details]

该适配器根据服务的 OpenAPI 合约生成工具，将签名密钥保留在本地，并拒绝已禁用、冲突、格式错误和超出上限的付款请求。请参阅付款流程、客户端示例和自动化验证。

安装

npx -y dopaminedesk-ai-data-marketplace-mcp

可在任何兼容 stdio 的 MCP 客户端中使用：

{
  "mcpServers": {
    "dopaminedesk-data-marketplace": {
      "command": "npx",
      "args": ["-y", "dopaminedesk-ai-data-marketplace-mcp"]
    }
  }
}

官方 MCP Registry 名称：io.github.jblaz6335/ai-data-marketplace。

为现有 Agent 提供精简工具列表

设置 X402_TOOL_MODE=compact，仅公开 find_marketplace_products 和 purchase_marketplace_product。所有上架产品仍可通过这两个工具使用。默认的 full 模式会保留面向现有集成的产品专用工具。

启动默认服务无需环境变量或钱包密钥。只有当买家选择在本地签名自动付款时才需要钱包。远程 /mcp URL 是独立的、经过身份验证的发布方集成，并非公开的 stdio 安装 URL。

可直接复制的配置以及免费的端到端客户端检查见 examples/README.md。该检查会发现一个真实产品并请求其免费预览，不会签名或提交付款。

使用额度购买，无需配置钱包

该服务已编入 APIHub 的外部 x402 目录。拥有 APIHub 额度的买家可以让其代理为市场调用签名并完成结算，无需在发起调用的进程中持有 Base 钱包或 gas：

npx @apihubio/cli register
npx @apihubio/cli topup 5
npx @apihubio/cli call https://ai-data-marketplace-1042299154756.us-central1.run.app/api/v1/evm_block_number

APIHub 是独立的第三方服务，拥有自己的账户、额度、加价和条款。直接使用 x402 仍是自我托管的途径。无论使用哪种方式，都会先结算受保护的端点，然后再交付付费结果。

查看实时合约

curl "https://ai-data-marketplace-1042299154756.us-central1.run.app/api/v1/company_intelligence?preview=true&domain=example.com"

证明内容包括来源、新鲜度、请求参数、顶层字段、响应结构和购买区块。可用于决策的值仍保留在付费结果中。

可选的单次调用购买

当前 npm 版本可自动完成 x402 挑战、授权、重试和结算。直接安装公开软件包：

npx -y dopaminedesk-ai-data-marketplace-mcp

买家密钥保留在本地 MCP 进程内，绝不会发送给市场。请使用余额较低的专用 Base 钱包，而不要使用主钱包。

{
  "mcpServers": {
    "dopaminedesk-data-marketplace": {
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "env": {
        "X402_AUTO_PAY": "true",
        "X402_EVM_PRIVATE_KEY": "YOUR_DEDICATED_BUYER_WALLET_KEY",
        "X402_MAX_PAYMENT_USDC": "0.25"
      }
    }
  }
}

调用产品时设置 auto_pay: true。适配器会拒绝已禁用、存在冲突、无效或超过上限的购买，不会退回到不设上限的付款方式。

如需自动安装客户端，请参阅 llms-install.md。其默认配置提供免费发现和预览，不会收集钱包密钥，也不会启用自动付款。

验证与工程范围

公开验证中心和机器验证记录公开了生产环境的证据。

我在设计此适配器时遵循了以下约束：

• 生产环境的 OpenAPI 合约是工具发现的事实来源；
• 实时合约证明会验证来源和架构，但不会替代付费产品；
• 自动购买需主动选择、在本地签名，并受每次调用的硬性上限保护；
• 冲突、格式错误、已禁用和超出上限的付款尝试都会安全失败；
• 结算详情会与交付的结果一并保留，以便对账。

在本地运行验证套件：

npm ci
npm test

生产环境合约

• 商店： https://ai-data-marketplace-1042299154756.us-central1.run.app/
• OpenAPI： https://ai-data-marketplace-1042299154756.us-central1.run.app/openapi.json
• Postman： https://ai-data-marketplace-1042299154756.us-central1.run.app/postman.json
• LLM 清单： https://ai-data-marketplace-1042299154756.us-central1.run.app/llms.txt
• x402 清单： https://ai-data-marketplace-1042299154756.us-central1.run.app/.well-known/x402
• x402scan： https://www.x402scan.com/server/8dd63536-ba25-40f4-b36a-7d05ed18d007

MCP 适配器根据生产环境的 OpenAPI 文档构建工具列表。数量、价格、可用性、数据模式和来源声明均取自实时合约，而非手写的端点列表。

每个计费产品都通过 Coinbase CDP facilitator，在 Base 主网上使用 x402 v2 精确支付：

1. 调用端点并读取 base64 PAYMENT-REQUIRED 响应标头。
2. 使用兼容的 x402 买家客户端签署精确授权。
3. 使用 PAYMENT-SIGNATURE 重试。
4. 从 PAYMENT-RESPONSE 读取结算详情。

手动和传统的已确认交易支付流程，请参阅 PAYMENT_FLOW.md。

买家可直接使用的成果

产品	付费调用提供的内容	价格（USDC）
shopify_store_lookup	当前公开的 Shopify 商品、变体、价格和库存情况	0.010
ssl_certificate	实时证书授权、颁发者、到期时间和指纹	0.010
stock_research_brief	当前市场报价与近期官方 SEC 文件元数据的整合信息	0.010
storefront_intelligence_report	在一份报告中提供公开 Shopify 商品目录、库存情况、TLS 信息和已声明的 Agent 商务证据	0.030
agent_readiness_audit	对 Agent 用于查找、了解网站并在网站上购物的发现文件提供评分证据和优先级排序后的修复建议	0.025
evm_receipt	提供 Base、Ethereum 或 Arbitrum 上的实时交易状态、Gas 用量、合约创建详情和规范化事件日志	0.003
evm_block_number	获取受支持 EVM 网络的当前区块高度，无需维护 RPC 集成	0.001
vendor_risk_report	提供供应商准入决策所需的当前身份、制裁、域名、TLS、托管和网站证据	0.020
x402_market_opportunity_report	实时 x402 需求、竞争、健康状况、定价和构建建议	0.010
transaction_preflight	签名前的只读交易模拟证据	0.005
company_intelligence	公司信息补充和供应商研究简报	0.010
x402_endpoint_preflight	x402 端点验证、质询检查和买方兼容性证据	0.003
website_due_diligence	在一份报告中提供网站信任、安全、元数据和风险证据	0.040
vehicle_safety_report	VIN 解码、召回、投诉和买方安全证据	0.008
crypto_market_snapshot	当前多资产定价和市场背景信息	0.004
这些是完整的付费交付成果，不是预告文案。对于只需读取单条链、备案、制裁检查、报价或验证结果的工作流，仍可使用较低层级的目录。

如果这个开源买家适配器为你节省了集成工作，你可以在 Ko-fi 上支持其维护。

已发布的分发渠道

• npm 包
• 官方 MCP 注册表
• Smithery
• x402scan

许可证

MIT 许可证。开源 MCP 买家适配器和市场客户端。