StackSwap — B2B GTM stack intelligence (hosted, Streamable HTTP, 17 tools)

StackSwap MCP

一个托管的 Model Context Protocol 服务，可让 AI 客户端使用 StackSwap 的 B2B SaaS GTM 技术栈情报，包括工具目录、供应商资料表、重叠检测、AI 原生替换建议、技术栈审计、N 路比较、类别全景、买家问题、续约谈判手册，以及完整文本的运营者知识库。

实时端点： https://stackswap.ai/api/mcp 文档： stackswap.ai/mcp 状态： 免费、无需 API 密钥、无状态。提供 17 个工具——16 个只读工具 + 1 个写入工具（submit_correction，提交后排队等待人工审核）。

此仓库包含托管 MCP 服务的公开文档、JSON 架构和示例客户端。服务本身为闭源——它作为 stackswap.ai 的一部分运行，并封装了为 Web 产品提供支持的同一套扫描引擎和工具目录。

---

安装

Claude Code

claude mcp add --transport http stackswap https://stackswap.ai/api/mcp

适用于用户范围（每个会话均可使用，而不仅限于某个项目）：

claude mcp add --transport http --scope user stackswap https://stackswap.ai/api/mcp

Claude Desktop

将配置添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "stackswap": {
      "url": "https://stackswap.ai/api/mcp",
      "transport": "http"
    }
  }
}

重启 Claude Desktop。聊天输入框中会出现工具指示器。

Cursor / ChatGPT Desktop / 其他 MCP 客户端

添加新的 HTTP MCP 服务，URL 为 https://stackswap.ai/api/mcp。无需身份验证。

---

工具

八个领域共提供 17 个工具。架构位于 schemas/tools.json（直接从实时 tools/list 响应中提取）。

目录

工具	功能
search_tools	按名称模糊搜索约 400 个 GTM 工具。每个匹配结果都会包含月度费用；如适用，还会提供 StackSwap 合作伙伴注册链接。
get_tool_details	单个工具的完整 StackSwap 资料：费用（目录价格 + 按席位计费，并附置信度）、AI 就绪度评分、类别、常见重叠项和替换注册状态。
get_vendor_fact_sheet	完整的供应商资料表（GTM Decision Schema v1.0.0）：包含注意事项的定价层级、集成深度评分、AI 能力，以及是否使用客户数据进行训练的披露信息。

技术栈分析

工具	功能
find_overlaps	给定一套技术栈，返回 StackSwap 已人工核验的冗余工具组合（104 对重叠项注册表），并列出整合后可节省的费用。
suggest_swaps	针对每种工具提供 AI 原生替换建议（Outreach → Smartlead、ZoomInfo → Apollo），并说明年度节省金额和原因。
scan_stack	预览 StackScan：输入工具、团队规模和行业，输出当前支出、优化后支出、每月/每年可节省金额，以及无头化缺口。
recommend_partner	给定需求（“outbound”“CRM”“automation”），返回 StackSwap 推荐的合作伙伴及其定位。
recommend_stack	针对某个行业领域提供参考入门技术栈，包含各工具费用、总支出、AI 就绪度和无头化就绪度评分。

比较

工具	功能
compare_tools	两两比较：费用差额、AI 就绪度、无头化就绪度（MCP/API 可调用性）、重叠状态，以及附有理由的推荐选择。
compare_tools_n_way	在一个 Markdown 矩阵中并排比较 2–6 个工具，包括费用、AI 就绪度、无头化就绪度、集合内的重叠项，以及 StackSwap 推荐选择。

内容

工具	功能
search_content	对约 50 篇一手运营者文章进行全文搜索，内容涵盖技术栈架构、AI 原生替换、RevOps 和决策框架。
get_kb_article	以 Markdown 格式获取知识库文章全文，并附规范 URL、类别和最后修改日期。

类别

工具	功能
get_category_landscape	全面了解某个 GTM 类别——涵盖领先者、次选方案和建议跳过或替换的工具，并列出各工具的成本、AI 就绪度和替换注册表状态。

检测

工具	功能
detect_stack_from_text	从自由文本中推断 GTM 技术栈（职业页面、招聘信息、网站 HTML、RFP、DevTools 网络标签页）。按匹配度排序，并提供置信度等级。

决策支持

工具	功能
get_buyer_questions	签约前向供应商提出的 10–20 个问题，并说明“为何重要”以及哪些回答属于危险信号。传入供应商名称后，还会提供该供应商特有的注意事项。
get_renewal_strategy	各供应商的续约谈判指南：筹码、价格锚点替代方案、适度的折扣要求、退出谈判的话术和时机窗口。

写入

工具	功能
submit_correction	提交目录修正（定价、功能、注意事项、评分）。提交内容会排队等待管理员审核，未经审核绝不会同步到面向用户的界面。

---

使用示例

安装后，在 AI 客户端中提出以下任一问题，它就会调用相应的工具：

运营人员的问题	调用的工具
“给我找一个冷邮件工具”	recommend_partner
“Smartlead 的费用是多少？”	get_tool_details
“Smartlead 和 Apollo 哪个更适合外呼？”	compare_tools
“比较 Smartlead、Instantly、Apollo 和 Lemlist”	compare_tools_n_way
“梳理整个销售互动类别”	get_category_landscape
“签约前我应该问 Apollo 什么？”	get_buyer_questions
“我的 Salesforce 将在 60 天后续约——我有哪些筹码？”	get_renewal_strategy
“这家公司用的是什么技术栈？”（粘贴职业页面）	detect_stack_from_text
“如果我在用 HubSpot + Salesforce + Outreach，有哪些功能重叠？”	find_overlaps
“审核我的技术栈：HubSpot、Salesforce、Outreach、ZoomInfo、Gong”	scan_stack
“查找 StackSwap 关于外呼数据伦理的文章”	search_content

工具描述可供模型读取，因此你无需知道工具名称——模型会根据问题选择合适的工具。

---

客户端示例

examples/client.ts 中提供了一个精简的 TypeScript 示例，可用于连接、列出工具并运行 find_overlaps。

npx tsx examples/client.ts

该协议是在 HTTP 上运行的纯 JSON-RPC 2.0——任何具有 JSON 解析器和 HTTP 客户端的语言都可以调用它。

---

端点详情

JSON-RPC URL	POST https://stackswap.ai/api/mcp
服务描述符	GET https://stackswap.ai/api/mcp（返回名称、版本和工具列表）
协议版本	2025-06-18、2025-03-26、2024-11-05
传输方式	可流式 HTTP，无状态
身份验证	无
速率限制	无（合理使用）
CORS	*

---

为何采用托管服务，而非 stdio

StackSwap 的 MCP 服务作为单个路由处理程序，运行在现有的 stackswap.ai Next.js 应用中。由我们自行托管意味着：

• 安装零阻力——只需一行 claude mcp add，无需 npm/pip 依赖
• 始终保持最新——底层工具目录、重叠注册表、供应商信息表和替换数据会随着 StackSwap 产品不断更新
• 本地计算为零——扫描引擎在服务端运行；客户端只需发送 JSON-RPC

代价是需要互联网连接，而且我们（StackSwap）可以看到请求量和工具调用模式。我们不会存储对话数据或用户标识符——该端点是无状态的。

---

请求、问题反馈

如果你希望添加工具、更改行为或遇到错误，请提交 issue。MCP 功能会根据运营人员的实际需求进行调整。

联系：[email protected]

---

许可证

MIT — 详见 LICENSE。

此许可证适用于本仓库中的公开文档、JSON 架构和示例客户端。不适用于运行于 stackswap.ai/api/mcp 的闭源服务实现。