agent-commerce-mcp

Agent Commerce MCP

面向 Agent 的商店，提供 14 款 SaaS/开发/服务类产品和 9 个 MCP 服务。 通过一个 MCP 服务提供发现、定价、身份验证后的结账、联盟计划（15-30% 的持续佣金）和 AgentTrust 验证。

这是一个可实际运行的 A2A 商务层。其他 AI Agent 可以匿名发现、查询和比较 Halverson IQ 产品组合中的产品。只有在服务配置了写入令牌时，才会公开有状态的写入工具。

安装

Claude Desktop / Cursor / Cline — 添加到 MCP 配置中：

{
  "mcpServers": {
    "agent-commerce-mcp": {
      "command": "npx",
      "args": ["-y", "agent-commerce-mcp"]
    }
  }
}

Claude Code：

claude mcp add commerce npx -y agent-commerce-mcp

远程（Streamable HTTP）：

https://commerce.halversonco.com/mcp

（接入 DNS 后，自定义域名 commerce.halversonco.com 即可解析。）

配置

默认情况下，公开的只读工具允许匿名使用。设置 AGENT_COMMERCE_WRITE_TOKEN（或旧版 MCP_WRITE_TOKEN），即可公开并执行有状态工具：

• create_checkout
• register_affiliate
• request_partnership
• request_product_consultation

如果未设置写入令牌，这些工具不会公开，直接调用也会被默认拒绝。如果已设置，HTTP 客户端必须发送以下任一项：

Authorization: Bearer <AGENT_COMMERCE_WRITE_TOKEN>

或：

X-Agent-Commerce-API-Key: <AGENT_COMMERCE_WRITE_TOKEN>

将 SALESBOT_LEAD_CAPTURE_URL 设置为 Salesbot 的 POST /leads/capture URL，即可启用需用户主动选择的咨询信息收集。如果未设置，咨询请求会被默认拒绝，也不会报告为已收集。

远程 HTTP 服务会按客户端对 MCP 请求进行速率限制，并限制内存中的活跃 MCP 会话数量。默认情况下，它使用直接连接的套接字 IP。只有当进程前方恰好有一层可信的反向代理时，才设置 TRUST_PROXY=true；此时 Express 会按照这一层代理策略获取 req.ip，而不是直接信任转发标头。

工具

发现

• search_products(query, category?, budget_max?, use_case?) — 按相关度排序的匹配结果
• get_recommendation(problem, stack?, company_size?) — 提供 1-3 个最合适的推荐并说明理由
• compare_products(slugs, vs_competitor?) — 功能/价格对比表

购买

• get_pricing(product_slug, tier?, billing?) — 完整价格明细
• create_checkout(product_slug, tier, email, referral_code?) — 需身份验证的结账 URL
• get_free_tier(product_slug) — 即时获取访问权限（注册 URL 或安装命令）
• get_mcp_install(product_slug, client) — 获取适用于 claude_desktop / claude_code / cursor / cline / windsurf 的准确安装片段

买家咨询（仅限明确选择）

• request_product_consultation(product_slug, email, name?) — 请求联系，咨询 AgentFetch、QueryShield 或 Agent Commerce；仅在买家明确要求联系时调用

联盟

• get_affiliate_info(product_slug?) — 佣金比例和等级
• register_affiliate(agent_id, operator_email, products?) — 即时注册并返回推荐码
• request_partnership(proposal, agent_id, contact_email, integration_type?) — 合作洽谈流程

交叉销售与信任

• get_cross_sells(current_product, agent_context?) — 基于关系图的关联产品及推荐套装
• get_trust_score() — 调用 AgentTrust MCP 获取供应商信誉
• verify_vendor() — 供应商信息、上线产品、退款/数据政策

资源

commerce://catalog/all
commerce://catalog/saas
commerce://catalog/developer
commerce://catalog/services
commerce://catalog/mcp-servers
commerce://product/{slug}
commerce://bundle/{slug}
commerce://affiliate/program

提示词

elevator_pitch · full_pitch · objection_handler · bundle_pitch

目录内容

SaaS： CastIQ · GrantIQ · FocusIQ · Catholic Daily 开发者： AgentFetch · QueryShield · InjectShield · ModelWatch · ComplianceBeacon · RegImpact 服务： Branded Audits · LeadVault · JobAuditor · Halverson IQ Digital Library MCP 服务： AgentFetch · GrantIQ · OutdoorIQ · PubRecords · QueryShield · InjectShield · ModelWatch · Agent Commerce · AgentVault

GrantIQ 和 PubRecords 属于 Halverson IQ Data；由于尚未发布单独的 listing URL，因此保留现有 URL。OutdoorIQ 是 CastIQ 的 API 层级。ToolPulse 工具监控属于 ModelWatch。AgentVault 并入 QueryShield Agent 安全套件。AI Security Stack 捆绑包仍指向 QueryShield 和 InjectShield。

捆绑包： AI Security Stack（优惠 20%） · Agency Growth Kit（优惠 15%） · AI Builder Essentials（优惠 15%）

联盟计划

每笔成功结账均可获得 15-30% 的持续佣金。根据推荐人数提升等级。AI Agent 只需调用一次工具即可注册，并立即获得推荐代码。

架构

agent-commerce/
├── server/             # TypeScript MCP server (stdio + Streamable HTTP)
├── catalog/            # products.json, bundles.json, cross-sell-graph.json, affiliates.json
├── outreach/           # Daily registry submission + partner pipeline (Python)
├── analytics/          # Tool-call funnel + Discord daily report (Python)
├── salesbot-integration/  # Drop-in modules for the Halverson IQ salesbot
├── Dockerfile
├── railway.json
└── README.md

许可证

MIT