StackSwap MCP

from StonesofCreation

B2B SaaS GTM stack intelligence — 17 tools spanning catalog search, overlap detection, n-way vendor comparison, decision-stage buyer questions, and renewal-negotiation playbooks.

🔥🔥🔥✓ VerifiedFreeQuick setup

#email #automation #crm #browser #git

StackSwap MCP

A hosted Model Context Protocol server that gives AI clients access to StackSwap'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.

Live endpoint: https://stackswap.ai/api/mcp Docs: stackswap.ai/mcp Status: Free, no API key, stateless. 17 tools — 16 read-only + 1 write (submit_correction, queued for human review).

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.

Tools

Seventeen tools across eight domains. Schemas are in schemas/tools.json (extracted directly from the live tools/list response).

Catalog

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.
`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.
`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.

Stack analysis

Tool	What it does
`find_overlaps`	Given a stack, return the redundant pairs StackSwap has hand-verified (104-pair overlap registry) with consolidation savings.
`suggest_swaps`	Per-tool AI-native replacement recommendations (Outreach → Smartlead, ZoomInfo → Apollo) with annual savings and reasoning.
`scan_stack`	Preview StackScan: tools + team size + industry in, current spend / optimized spend / monthly-annual recoverable / headless gaps out.
`recommend_partner`	Given a need ("outbound", "CRM", "automation"), return StackSwap's recommended partner(s) with positioning.
`recommend_stack`	Reference starter stack for an industry vertical with per-tool cost, total spend, AI-readiness and headless-readiness scores.

Compare

Tool	What it does
`compare_tools`	Head-to-head: cost delta, AI-readiness, headless-readiness (MCP/API callability), overlap status, and a recommended pick with reasoning.
`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.

Content

Tool	What it does
`search_content`	Full-text search across ~50 first-party operator articles on stack architecture, AI-native swaps, RevOps, and decision frameworks.
`get_kb_article`	Fetch a knowledge-base article's full body as markdown, with canonical URL, category, and last-modified date.

Tool	What it does
`get_category_landscape`	Full map of one GTM category — leaders, runner-ups, skip/replace candidates — with cost, AI-readiness, swap-registry status per tool.

Detect

Tool	What it does
`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.

Decision support

Tool	What it does
`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.
`get_renewal_strategy`	Renewal-negotiation playbook per vendor: leverage points, price-anchor alternatives, calibrated discount ask, walkaway script, timing window.

Write

Tool	What it does
`submit_correction`	Submit a catalog correction (pricing, features, gotchas, scores). Queued for admin review — never propagates to user-facing surfaces unreviewed.

Example client

A minimal TypeScript example that connects, lists tools, and runs find_overlaps is in examples/client.ts.

Copy & paste — that's it

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 add line, no npm/pip dependency
Always current — the underlying tool catalog, overlap registry, vendor fact sheets, 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.

Copy & paste — that's it

npx tsx examples/client.ts

Install

Claude Code

Copy & paste — that's it

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

For user-scope (available in every session, not just one project):

Copy & paste — that's it

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):

Copy & paste — that's it

{
  "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.

Example usage

Once installed, ask any of the following in your AI client and it 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`
"Compare Smartlead, Instantly, Apollo, and Lemlist"	`compare_tools_n_way`
"Map the whole sales-engagement category"	`get_category_landscape`
"What should I ask Apollo before signing?"	`get_buyer_questions`
"My Salesforce renewal is in 60 days — what's my leverage?"	`get_renewal_strategy`
"What stack does this company run?" (paste a careers page)	`detect_stack_from_text`
"What overlaps if I'm on HubSpot + Salesforce + Outreach?"	`find_overlaps`
"Audit my stack: HubSpot, Salesforce, Outreach, ZoomInfo, Gong"	`scan_stack`
"Find StackSwap's article on data ethics in outbound"	`search_content`

Tool descriptions are model-readable, so you don't need to know the tool names — the model picks based on the question.

StackSwap MCP

Tools

Catalog

Stack analysis

Compare

Content

Categories

Detect

Decision support

Write

Example client

Endpoint details

Why hosted, not stdio

Requests, issues, feedback

License

Install

Claude Code

Claude Desktop

Cursor / ChatGPT Desktop / Other MCP clients

Example usage