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.
Tools
Seventeen tools across eight domains. Schemas are in schemas/tools.json (extracted directly from the live tools/list response).
Catalog
Stack analysis
Compare
Content
Categories
Detect
Decision support
Write
Example usage
Once installed, ask any of the following in your AI client and it will route to the right tool:
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
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, 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.