Stackswap
StackSwap MCP
A hosted Model Context Protocol server that gives AI clients access to StackSwap's B2B SaaS GTM stack intelligence — tool catalog, overlap detection, AI-native swap suggestions, stack audits, and partner recommendations.
Live endpoint: https://stackswap.ai/api/mcp
Docs: stackswap.ai/mcp
Status: Free, no API key, stateless, read-only.
This 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 and wraps the same scan engine and tool catalog that powers the web product.
Install
Claude Code
claude mcp add --transport http stackswap https://stackswap.ai/api/mcp
For user-scope (available in every session, not just one project):
claude mcp add --transport http --scope user stackswap https://stackswap.ai/api/mcp
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"stackswap": {
"url": "https://stackswap.ai/api/mcp",
"transport": "http"
}
}
}
Restart Claude Desktop. A tools indicator appears in the chat compose box.
Cursor / ChatGPT Desktop / Other MCP clients
Add a new HTTP MCP server with URL https://stackswap.ai/api/mcp. No authentication.
Tools
Eight read-only tools. Schemas are in schemas/tools.json (extracted directly from the live tools/list response).
| Tool | What it does |
|---|---|
search_tools | Fuzzy-search ~400 GTM tools by name. Returns each match with monthly cost and a StackSwap partner sign-up link when applicable. |
find_overlaps | Given a stack, return the 104 curated overlap pairs StackSwap has hand-verified, with consolidation savings. |
suggest_swaps | For each input tool, return StackSwap's AI-native replacement recommendation (when one exists) with annual savings and reasoning. |
scan_stack | Preview StackScan: pass tools + team size + industry, get back monthly/annual recoverable spend and the top 5 replace/remove opportunities. |
recommend_partner | Given a need (e.g. "outbound", "CRM", "automation"), return StackSwap's recommended affiliate partner with sign-up URL and implementation hours. |
compare_tools | Head-to-head comparison of two GTM tools. Returns cost delta, AI-readiness delta, overlap warning, and a recommended pick with reasoning. |
recommend_stack | StackSwap's reference starter stack for a given industry vertical, with per-tool cost and total monthly/annual spend. |
get_tool_details | Full StackSwap profile on a single tool: cost, AI-readiness, common overlaps, swap registry status, partner status. |
Example usage
Once installed, ask any of the following in your AI client and Claude will route to the right tool:
| Operator question | Tool that fires |
|---|---|
| "Find me a cold-email tool" | recommend_partner |
| "What does Smartlead cost?" | get_tool_details |
| "Smartlead vs Apollo for outbound?" | compare_tools |
| "Build a stack for a marketing agency, 10-25 people" | recommend_stack |
| "What overlaps if I'm on HubSpot + Salesforce + Outreach?" | find_overlaps |
| "What AI-native tool replaces ZoomInfo?" | suggest_swaps |
| "Audit my current stack: HubSpot, Salesforce, Outreach, ZoomInfo, Gong" | scan_stack |
| "Show me tools matching 'attribution'" | search_tools |
Tool descriptions are model-readable, so you don't need to know the tool names — Claude picks based on the question.
Example client
A minimal TypeScript example that connects, lists tools, and runs find_overlaps is in examples/client.ts.
npx tsx examples/client.ts
The protocol is plain JSON-RPC 2.0 over HTTP — any language with a JSON parser and an HTTP client can call it.
Endpoint details
| JSON-RPC URL | POST https://stackswap.ai/api/mcp |
| Server descriptor | GET https://stackswap.ai/api/mcp (returns name, version, tool list) |
| Protocol versions | 2025-06-18, 2025-03-26, 2024-11-05 |
| Transport | Streamable HTTP, stateless |
| Auth | None |
| Rate limit | None (reasonable use) |
| CORS | * |
Why hosted, not stdio
StackSwap's MCP server runs inside the existing stackswap.ai Next.js application as a single route handler. Hosting it ourselves means:
- No install friction — one
claude mcp addline, no npm/pip dependency - Always current — the underlying tool catalog, overlap registry, and swap data update as the StackSwap product evolves
- Zero local compute — the scan engine runs server-side; clients just send JSON-RPC
The 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.
Requests, issues, feedback
Open 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.
Contact: nick@stackswap.ai
License
MIT — see LICENSE.
This 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.
Server Config
{
"mcpServers": {
"stackswap": {
"url": "https://stackswap.ai/api/mcp",
"transport": "http"
}
}
}