{
  "markdown": "# StackSwap MCP\n\n[![smithery badge](https://smithery.ai/badge/nicholasallenfrench/stackswap)](https://smithery.ai/servers/nicholasallenfrench/stackswap)\n\nA hosted [Model Context Protocol](https://modelcontextprotocol.io) server that gives AI clients access to [StackSwap](https://stackswap.ai)'s B2B SaaS GTM stack intelligence — tool catalog, vendor fact sheets, overlap detection, AI-native swap suggestions, stack audits, n-way comparisons, category landscapes, buyer questions, renewal-negotiation playbooks, and a full-text operator knowledge base.\n\n**Live endpoint:** `https://stackswap.ai/api/mcp`\n**Docs:** [stackswap.ai/mcp](https://stackswap.ai/mcp)\n**Status:** Free, no API key, stateless. 17 tools — 16 read-only + 1 write (`submit_correction`, queued for human review).\n\nThis repo contains **public documentation, JSON schemas, and an example client** for the hosted MCP server. The server itself is closed-source — it runs as part of [stackswap.ai](https://stackswap.ai) and wraps the same scan engine and tool catalog that powers the web product.\n\n---\n\n## Install\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http stackswap https://stackswap.ai/api/mcp\n```\n\nFor user-scope (available in every session, not just one project):\n\n```bash\nclaude mcp add --transport http --scope user stackswap https://stackswap.ai/api/mcp\n```\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"stackswap\": {\n      \"url\": \"https://stackswap.ai/api/mcp\",\n      \"transport\": \"http\"\n    }\n  }\n}\n```\n\nRestart Claude Desktop. A tools indicator appears in the chat compose box.\n\n### Cursor / ChatGPT Desktop / Other MCP clients\n\nAdd a new HTTP MCP server with URL `https://stackswap.ai/api/mcp`. No authentication.\n\n---\n\n## Tools\n\nSeventeen tools across eight domains. Schemas are in [`schemas/tools.json`](./schemas/tools.json) (extracted directly from the live `tools/list` response).\n\n### Catalog\n\n| Tool | What it does |\n|---|---|\n| `search_tools` | Fuzzy-search ~400 GTM tools by name. Returns each match with monthly cost and a StackSwap partner sign-up link when applicable. |\n| `get_tool_details` | Full StackSwap profile for a single tool: cost (catalog + per-seat with confidence), AI-readiness score, category, common overlaps, swap-registry status. |\n| `get_vendor_fact_sheet` | Full vendor fact sheet (GTM Decision Schema v1.0.0): pricing tiers with gotchas, integration depth scores, AI capabilities + customer-data-for-training disclosure. |\n\n### Stack analysis\n\n| Tool | What it does |\n|---|---|\n| `find_overlaps` | Given a stack, return the redundant pairs StackSwap has hand-verified (104-pair overlap registry) with consolidation savings. |\n| `suggest_swaps` | Per-tool AI-native replacement recommendations (Outreach → Smartlead, ZoomInfo → Apollo) with annual savings and reasoning. |\n| `scan_stack` | Preview StackScan: tools + team size + industry in, current spend / optimized spend / monthly-annual recoverable / headless gaps out. |\n| `recommend_partner` | Given a need (\"outbound\", \"CRM\", \"automation\"), return StackSwap's recommended partner(s) with positioning. |\n| `recommend_stack` | Reference starter stack for an industry vertical with per-tool cost, total spend, AI-readiness and headless-readiness scores. |\n\n### Compare\n\n| Tool | What it does |\n|---|---|\n| `compare_tools` | Head-to-head: cost delta, AI-readiness, headless-readiness (MCP/API callability), overlap status, and a recommended pick with reasoning. |\n| `compare_tools_n_way` | 2–6 tools side-by-side in one markdown matrix — cost, AI-readiness, headless-readiness, overlaps within the set, StackSwap pick. |\n\n### Content\n\n| Tool | What it does |\n|---|---|\n| `search_content` | Full-text search across ~50 first-party operator articles on stack architecture, AI-native swaps, RevOps, and decision frameworks. |\n| `get_kb_article` | Fetch a knowledge-base article's full body as markdown, with canonical URL, category, and last-modified date. |\n\n### Categories\n\n| Tool | What it does |\n|---|---|\n| `get_category_landscape` | Full map of one GTM category — leaders, runner-ups, skip/replace candidates — with cost, AI-readiness, swap-registry status per tool. |\n\n### Detect\n\n| Tool | What it does |\n|---|---|\n| `detect_stack_from_text` | Infer a GTM stack from freeform text (careers page, job posting, site HTML, RFP, DevTools network tab). Ranked matches with confidence levels. |\n\n### Decision support\n\n| Tool | What it does |\n|---|---|\n| `get_buyer_questions` | 10–20 questions to ask a vendor before signing, with \"why it matters\" and red-flag answers. Vendor-specific gotchas when you pass a vendor. |\n| `get_renewal_strategy` | Renewal-negotiation playbook per vendor: leverage points, price-anchor alternatives, calibrated discount ask, walkaway script, timing window. |\n\n### Write\n\n| Tool | What it does |\n|---|---|\n| `submit_correction` | Submit a catalog correction (pricing, features, gotchas, scores). Queued for admin review — never propagates to user-facing surfaces unreviewed. |\n\n---\n\n## Example usage\n\nOnce installed, ask any of the following in your AI client and it will route to the right tool:\n\n| Operator question | Tool that fires |\n|---|---|\n| \"Find me a cold-email tool\" | `recommend_partner` |\n| \"What does Smartlead cost?\" | `get_tool_details` |\n| \"Smartlead vs Apollo for outbound?\" | `compare_tools` |\n| \"Compare Smartlead, Instantly, Apollo, and Lemlist\" | `compare_tools_n_way` |\n| \"Map the whole sales-engagement category\" | `get_category_landscape` |\n| \"What should I ask Apollo before signing?\" | `get_buyer_questions` |\n| \"My Salesforce renewal is in 60 days — what's my leverage?\" | `get_renewal_strategy` |\n| \"What stack does this company run?\" (paste a careers page) | `detect_stack_from_text` |\n| \"What overlaps if I'm on HubSpot + Salesforce + Outreach?\" | `find_overlaps` |\n| \"Audit my stack: HubSpot, Salesforce, Outreach, ZoomInfo, Gong\" | `scan_stack` |\n| \"Find StackSwap's article on data ethics in outbound\" | `search_content` |\n\nTool descriptions are model-readable, so you don't need to know the tool names — the model picks based on the question.\n\n---\n\n## Example client\n\nA minimal TypeScript example that connects, lists tools, and runs `find_overlaps` is in [`examples/client.ts`](./examples/client.ts).\n\n```bash\nnpx tsx examples/client.ts\n```\n\nThe protocol is plain JSON-RPC 2.0 over HTTP — any language with a JSON parser and an HTTP client can call it.\n\n---\n\n## Endpoint details\n\n| | |\n|---|---|\n| **JSON-RPC URL** | `POST https://stackswap.ai/api/mcp` |\n| **Server descriptor** | `GET https://stackswap.ai/api/mcp` (returns name, version, tool list) |\n| **Protocol versions** | `2025-06-18`, `2025-03-26`, `2024-11-05` |\n| **Transport** | Streamable HTTP, stateless |\n| **Auth** | None |\n| **Rate limit** | None (reasonable use) |\n| **CORS** | `*` |\n\n---\n\n## Why hosted, not stdio\n\nStackSwap's MCP server runs inside the existing [stackswap.ai](https://stackswap.ai) Next.js application as a single route handler. Hosting it ourselves means:\n\n- **No install friction** — one `claude mcp add` line, no npm/pip dependency\n- **Always current** — the underlying tool catalog, overlap registry, vendor fact sheets, and swap data update as the StackSwap product evolves\n- **Zero local compute** — the scan engine runs server-side; clients just send JSON-RPC\n\nThe trade-off: it requires an internet connection, and we (StackSwap) see request volume and tool-call patterns. We don't store conversation data or user identifiers — the endpoint is stateless.\n\n---\n\n## Requests, issues, feedback\n\nOpen an issue if you want a tool added, a behavior changed, or you've hit a bug. The MCP surface is shaped by what operators actually ask about.\n\nContact: [nick@stackswap.ai](mailto:nick@stackswap.ai)\n\n---\n\n## License\n\nMIT — see [LICENSE](./LICENSE).\n\nThis license covers the public documentation, JSON schemas, and example clients in this repository. It does not cover the closed-source server implementation that runs at `stackswap.ai/api/mcp`.\n",
  "bytes": 8124,
  "sha": "7f92d801fcf370821dec54555f65cbc4ab71618bb42e6843fe179b8d3b9702f3",
  "repo_slug": "stonesofcreation/stackswap-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_stonesofcreation_stackswap_36b7e798/readme"
}