StackSwap

io.github.StonesofCreationPublished by GitHub account StonesofCreationv1.1.0Updated Oct 24, 2026

B2B GTM stack intelligence: search ~400 tools, compare vendors, find overlaps, audit SaaS spend.

VerifiedStreamable HTTPWeb executableKnowledge & MemoryData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

StackSwap is a hosted MCP server for B2B GTM stack intelligence, letting an assistant search ~400 SaaS tools, compare vendors, find overlaps and audit spend.

What you can do
Search and profile tools: fuzzy-search the catalog, get full tool details, vendor fact sheets and category landscapes with costs and AI-readiness scores. Compare vendors: head-to-head or 2–6 tools side by side, with a recommended pick. Analyze a stack: find redundant overlaps, suggest AI-native swaps, run a preview spend scan, and recommend a starter stack or partner. Detect a stack from freeform text such as a careers page or RFP. Read decision content: search and fetch knowledge-base articles, buyer questions and renewal-negotiation playbooks. Run guided stack audits and generate data-layer blueprints or build prompts. Submit catalog corrections for review.
When to use it
Useful when choosing, comparing, auditing or renewing B2B SaaS sales and marketing tools, or when an assistant needs cost, overlap and AI-readiness data on a GTM stack. Also suited to greenfield questions about which tools to buy for an industry.
Requirements
A remote streamable HTTP endpoint; no local package, API key or authentication. Requires an internet connection. The README notes the server is stateless and free.
Before you install
The server is closed-source and hosted by StackSwap, which sees request volume and tool-call patterns, though it says it stores no conversation data or user identifiers. Results include StackSwap partner and affiliate sign-up links and recommendations, so treat vendor picks as commercially motivated. The preview scan links to a paid audit. submit_correction writes data, but submissions are queued for human review.

Installation

In SourceWeft

  1. Open StackSwap in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.StonesofCreation%2Fstackswap/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

StackSwap MCP

[smithery badge]

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.


Install

Claude Code

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

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

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

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

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

Catalog

ToolWhat it does
search_toolsFuzzy-search ~400 GTM tools by name. Returns each match with monthly cost and a StackSwap partner sign-up link when applicable.
get_tool_detailsFull StackSwap profile for a single tool: cost (catalog + per-seat with confidence), AI-readiness score, category, common overlaps, swap-registry status.
get_vendor_fact_sheetFull 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

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

Compare

ToolWhat it does
compare_toolsHead-to-head: cost delta, AI-readiness, headless-readiness (MCP/API callability), overlap status, and a recommended pick with reasoning.
compare_tools_n_way2–6 tools side-by-side in one markdown matrix — cost, AI-readiness, headless-readiness, overlaps within the set, StackSwap pick.

Content

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

Categories

ToolWhat it does
get_category_landscapeFull map of one GTM category — leaders, runner-ups, skip/replace candidates — with cost, AI-readiness, swap-registry status per tool.

Detect

ToolWhat it does
detect_stack_from_textInfer a GTM stack from freeform text (careers page, job posting, site HTML, RFP, DevTools network tab). Ranked matches with confidence levels.

Decision support

ToolWhat it does
get_buyer_questions10–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_strategyRenewal-negotiation playbook per vendor: leverage points, price-anchor alternatives, calibrated discount ask, walkaway script, timing window.

Write

ToolWhat it does
submit_correctionSubmit a catalog correction (pricing, features, gotchas, scores). Queued for admin review — never propagates to user-facing surfaces unreviewed.

Example usage

Once installed, ask any of the following in your AI client and it will route to the right tool:

Operator questionTool 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.


Example client

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

bash
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 URLPOST https://stackswap.ai/api/mcp
Server descriptorGET https://stackswap.ai/api/mcp (returns name, version, tool list)
Protocol versions2025-06-18, 2025-03-26, 2024-11-05
TransportStreamable HTTP, stateless
AuthNone
Rate limitNone (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: [email protected]


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.

Source: README.md at commit 9520574

Tools

23

inspect_available_connections

Identify available connected systems and the read-only evidence StackSwap needs. The server cannot introspect neighboring MCPs automatically.

ParameterssystemsauditGoal

request_system_connection

Return a safe, read-only connection or export request for a named system when an audit lacks evidence.

ParameterssystemrequiredpurposepreferredMode

start_stack_audit

Start an adaptive GTM architecture audit and return the smallest discovery questionnaire needed before KEEP, SWAP, or BUILD recommendations.

Parametersgoalstagemotionsystems

complete_stack_audit

Turn user answers and connected-system evidence into explainable KEEP, SWAP, and BUILD recommendations with confidence, alternatives, and next prompts.

ParametersgoalstagemotionanswerssystemsrequiredconstraintsconnectedEvidence

generate_data_layer_blueprint

Generate a case-specific GTM data-layer blueprint when systems mirror state, drift, or lack explicit ownership.

ParametersproblemrequiredsystemsrequiredentitiesprimarySourceOfTruth

generate_build_prompt

Generate a copy-ready one-shot build or migration prompt from a StackSwap KEEP, SWAP, or BUILD recommendation.

Parametersoutputtargetsystemsrecommendationrequired

search_tools

Search StackSwap's catalog of ~400 GTM tools by name. Returns each match with its catalogued monthly cost and, when applicable, a StackSwap partner sign-up link.

Parameterslimitquery

get_tool_details

Full StackSwap profile for a single tool: cost (catalog + per-seat with confidence; vendor fact sheet wins when fresh), AI-readiness score, category, common overlaps, swap-registry status, and partner sign-up link. Use when the user wants depth on one tool (more than search_tools' name + cost).

Parametersnamerequired

get_vendor_fact_sheet

Return the full vendor fact sheet (per GTM Decision Schema v1.0.0) for a tool, when one exists. Includes pricing tiers with gotchas, integration depth scores, AI capabilities + customer-data-for-training disclosure, affiliate program terms, and self-disclosed conflicts (vendor-claim vs user-reported). Provenance is labeled (vendor / stackswap / community) and freshness is computed against a 90-day window. Use when an agent or buyer needs the structured machine-readable view of a tool — strictly more detail than `get_tool_details`. Returns a not-found message + a pointer to /vendors/submit-fact-sheet when no fact sheet exists.

Parameterstoolrequired

find_overlaps

Given a list of tool names in a user's stack, return the redundant pairs StackSwap has curated (104 hand-verified overlaps) along with monthly/annual savings if one is consolidated.

Parameterstoolsrequired

suggest_swaps

For each tool supplied, return StackSwap's AI-native replacement recommendation (when one exists) with annual savings and reasoning. Skews toward legacy → modern swaps (Outreach → Smartlead, ZoomInfo → Apollo, etc.).

Parameterstoolsrequired

scan_stack

Run a preview StackScan: pass a list of tools + team size + industry, get back current spend, optimized spend, monthly/annual recoverable, headless gaps (tools with no MCP/API connection an owned head can call), and the top 5 replace/remove opportunities. Includes a link to the full paid audit on stackswap.ai.

ParameterstoolsrequiredindustryteamSize

recommend_partner

Given a need (e.g. 'outbound', 'CRM', 'automation'), return StackSwap's recommended affiliate partner(s) with sign-up URL and positioning.

Parameterscategoryrequired

recommend_stack

StackSwap's reference starter stack for a given industry vertical. Returns a curated tool list with per-tool cost, total monthly/annual spend, AI-readiness and headless-readiness scores, and partner sign-up links. Use for greenfield 'what stack should I buy?' queries — distinct from scan_stack (audits an existing stack) and recommend_partner (single category).

ParametersbudgetindustryrequiredteamSize

compare_tools

Head-to-head comparison of two GTM tools. Returns cost delta, AI-readiness and headless-readiness (MCP/API callability — can an agent or your own dashboard drive it) scores, overlap status, swap-registry signal, and StackSwap's recommended pick with reasoning. Use when the user is choosing between two specific vendors (e.g. 'Salesforce vs HubSpot', 'Outreach vs Smartlead').

Parametersarequiredbrequired

compare_tools_n_way

Side-by-side comparison of 2–6 GTM tools in one shot. Returns a markdown matrix (cost, AI-readiness, headless-readiness, overlaps within the set, swap-registry status, StackSwap pick) and per-tool partner sign-up links. Use for category bake-offs (e.g. 'Apollo vs ZoomInfo vs Cognism vs Clay'). Prefer the 2-way compare_tools for clean head-to-head pairs.

Parameterstoolsrequired

search_content

Full-text search across StackSwap's first-party GTM knowledge base — ~50 operator-narrative articles on stack architecture, AI-native swaps, RevOps, data ethics, and decision frameworks. Returns ranked articles with title, slug, category, summary, and URL. Use when the user asks a GTM strategy/architecture/methodology question that's been written about (e.g. 'how should I think about CRM migration', 'what's wrong with intent data', 'how to audit my stack'). Cite the URL in your reply. Pass slug to `get_kb_article` for the full body.

Parameterslimitqueryrequiredcategory

get_kb_article

Fetch the full body of a StackSwap knowledge base article as markdown. Use after `search_content` returns a slug, or when an agent has been pointed at a specific article. Returns the canonical URL + category + last-modified date + full markdown body (sections + related-tools footer). Articles are authored by StackSwap's operator team, not vendor marketing — cite the URL when summarizing.

Parametersslugrequired

get_category_landscape

Full map of one GTM category — leaders, runner-ups, and skip/replace candidates. Returns every catalogued tool in the bucket with cost, AI-readiness, swap-registry status, and partner sign-up links. Use when the user wants to see the full landscape for a category (e.g. 'show me all CRMs', 'what outbound tools exist', 'map the analytics category') — strictly more comprehensive than `recommend_partner` (single best pick). Known buckets: crm, outbound, data, marketing-automation, analytics, meetings, support, scheduling, automation, seo, cdp, revenue-intelligence, chat, collaboration, phone, landing-pages, linkedin, ai-content, saas-mgmt, enablement, ai-tooling.

Parameterslimitcategoryrequired

detect_stack_from_text

Infer a GTM stack from a freeform text blob (a careers page, job posting, public site HTML, RFP, 'What we use' doc, browser DevTools network tab, etc.). Returns ranked tool matches with confidence levels (high/medium/low) and evidence snippets, plus a ready-to-use array for chaining into `scan_stack` or `find_overlaps`. Use when the user says 'I don't know what we use' or pastes a competitor's careers page to scout. Conservative on ambiguous short tokens — multi-mention or canonical-name matches win.

Parameterstextrequired

get_buyer_questions

Return 10-20 questions a B2B GTM buyer should ask a vendor before signing — with 'why it matters' and 'watch for' red-flag answers. Pass `vendor` for vendor-specific gotchas (e.g. Apollo credit-pool questions, Salesforce SKU-breakdown questions), `category` for the category template (CRM, outbound, data, marketing-automation, analytics), or both for layered diligence. Authored by StackSwap's operator team (Nick French, 10+ yrs B2B SaaS GTM). Use when the user is evaluating a vendor, prepping for a sales call, or building a procurement checklist.

Parametersvendorcategory

get_renewal_strategy

Return StackSwap's renewal-negotiation playbook for a specific vendor: leverage points (why they will discount), price-anchor alternatives to cite, a calibrated discount ask, a walkaway script, optimal timing window, and contract-trap callouts. Pass `monthlySpend` to compute target savings. Optional `contractEndsIn` flags compressed-timeline adjustments. Authored from operator experience across major B2B SaaS renewals (Salesforce, HubSpot, ZoomInfo, Apollo, Outreach, Smartlead, Gong, Clay). Use when the user mentions a renewal, a price increase, or 'we're up for renewal' conversations.

ParametersvendorrequiredmonthlySpendcontractEndsIn

submit_correction

Submit a correction to the StackSwap catalog (pricing, feature list, gotcha, AI-readiness score, category, or other). Submissions queue for admin review and only propagate to user-facing surfaces after merge — they DO NOT immediately mutate the catalog. Use when the user notices a stale price, an inaccurate feature list, a gotcha that should be flagged, or wants to report a tool we don't cover. Two-way data flow that helps keep the catalog accurate. Returns a correction ID + reassurance that the submission is queued.

Parameterstoolrequiredfieldrequiredsource_urlcurrent_valueproposed_valuerequiredreporter_context

Version history

1
  1. v1.1.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts