Skip to main content
Glama
nickfrench-gtm

StackSwap

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.


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.


Related MCP server: mcp-services

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.

Categories

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


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

Related MCP Connectors

  • Pay-per-use tool marketplace for AI agents. Search, price-check, and call APIs via MCP.

  • Your agent needs live data — a competitor's traffic, who to contact there, what people are saying, what Google and ChatGPT answer about you, a company's filings. Normally that is six vendor accounts, six sets of keys and six SDKs. This is one URL. **What you can ask for** • "How much traffic does stripe.com get, where does it come from, and who competes for the same keywords?" • "Find 20 Series-B fintech companies in Germany and the heads of marketing there, with emails." • "Does ChatGPT mention our brand when someone asks for the best CRM — and what does it cite?" • "What is X saying about $NVDA today, and what did the stock actually do?" • "Search the web for this, then scrape the three best pages into markdown." **How to use it** Point any MCP client at https://mcp.aisa.one/mcp and sign in with OAuth — there is no key to create or paste. Then just ask: the agent calls search to find the right operation and use to run it. **Why this rather than the source** 26 sources behind one account and one bill — DataForSEO, Semrush, Ahrefs, Similarweb, Apollo, X/Twitter, Instagram, Reddit, Pinterest, YouTube, Tavily, Exa, Perplexity, Firecrawl, CoinGecko, Kalshi, Polymarket, AgentMail and more, 580+ operations. tools/list returns five tools, not 580, so the introduction does not eat your context window. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** One slice at a time: https://mcp.aisa.one/seo/mcp · /finance/mcp · /social/mcp · /search/mcp · /sales/mcp · /mail/mcp · /gtm/mcp, or a single provider like /twitter-api/mcp. Same account, fewer tools listed, and search still reaches everything. Full list at https://mcp.aisa.one/servers

  • Hosted MCP server for LLM cost estimation, model comparison, and budget-aware routing.

  • The OpenRouter for tools. One MCP connection gives any AI agent 254 hosted tools, pay per call.

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    Collection of B2B sales intelligence MCP servers. Includes website analysis, tech stack detection, hiring signals, review aggregation, ad tracking, social profiles, financial reporting and more for AI-powered prospecting
    1
    2
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Multi-tool MCP server for AI agents with 29 tools across web scraping, SEO analysis, screenshot and PDF generation, domain intelligence, content extraction, multi-chain EVM blockchain queries, and security toolkit. Free tier available with no auth required.
    20 npm
    1
    MIT
  • F
    license
    Not graded
    quality
    F
    maintenance
    Search and discover 100+ hosted MCP servers on Cloudflare's edge with semantic search. Browse tools, get full parameter schemas,and execute functions — one URL, no auth needed for discovery. Includes Slack, Stripe, GitHub, AWS, Discord, Salesforce, and 90+ more.
    2
    -
  • A
    license
    A
    quality
    A
    maintenance
    Query verified pricing, aggregated user ratings, feature comparisons, and category rankings for 508+ SaaS, AI, and security tools across 45 categories. No API key required - install with npx @comparedge/mcp-server
    8
    72 npm
    3
    MIT