StackSwap MCP

oficial

Inteligência de pilha GTM para SaaS B2B — 17 ferramentas que abrangem pesquisa de catálogo, detecção de sobreposição, comparação de fornecedores em múltiplas vias, perguntas de compradores em estágio de decisão e playbooks de negociação de renovação.

GitHub

Documentação

StackSwap MCP

Um servidor hospedado do Model Context Protocol que fornece a clientes de IA acesso à inteligência da stack de GTM B2B SaaS do StackSwap — catálogo de ferramentas, fichas técnicas de fornecedores, detecção de sobreposições, sugestões de substituição nativas de IA, auditorias de stack, comparações n-way, panoramas de categorias, perguntas para compradores, playbooks de negociação de renovação e uma base de conhecimento de texto completo para operadores.

Endpoint ativo: https://stackswap.ai/api/mcp Documentação: stackswap.ai/mcp Status: Gratuito, sem chave de API, sem estado. 17 ferramentas — 16 somente leitura + 1 de escrita (submit_correction, enfileirada para revisão humana).

Este repositório contém documentação pública, esquemas JSON e um cliente de exemplo para o servidor MCP hospedado. O servidor em si é de código fechado — ele roda como parte do stackswap.ai e encapsula o mesmo motor de varredura e catálogo de ferramentas que alimenta o produto web.

Instalação

Claude Code

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

Para escopo de usuário (disponível em todas as sessões, não apenas em um projeto):

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

Claude Desktop

Adicione ao ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Reinicie o Claude Desktop. Um indicador de ferramentas aparece na caixa de composição do chat.

Cursor / ChatGPT Desktop / Outros clientes MCP

Adicione um novo servidor MCP HTTP com a URL https://stackswap.ai/api/mcp. Sem autenticação.

Ferramentas

Dezessete ferramentas em oito domínios. Os esquemas estão em schemas/tools.json (extraídos diretamente da resposta ativa do tools/list).

Catálogo

Ferramenta	O que faz
`search_tools`	Busca difusa de ~400 ferramentas de GTM por nome. Retorna cada correspondência com custo mensal e um link de inscrição de parceiro StackSwap quando aplicável.
`get_tool_details`	Perfil completo do StackSwap para uma única ferramenta: custo (catálogo + por usuário com confiança), pontuação de prontidão para IA, categoria, sobreposições comuns, status no registro de substituições.
`get_vendor_fact_sheet`	Ficha técnica completa do fornecedor (GTM Decision Schema v1.0.0): níveis de preço com armadilhas, pontuações de profundidade de integração, capacidades de IA + divulgação de dados de clientes para treinamento.

Análise de stack

Ferramenta	O que faz
`find_overlaps`	Dada uma stack, retorna os pares redundantes que o StackSwap verificou manualmente (registro de 104 pares de sobreposição) com economia de consolidação.
`suggest_swaps`	Recomendações de substituição nativas de IA por ferramenta (Outreach → Smartlead, ZoomInfo → Apollo) com economia anual e justificativa.
`scan_stack`	Pré-visualização do StackScan: ferramentas + tamanho da equipe + setor como entrada, gasto atual / gasto otimizado / recuperável mensal-anual / lacunas headless como saída.
`recommend_partner`	Dada uma necessidade ("outbound", "CRM", "automação"), retorna o(s) parceiro(s) recomendado(s) pelo StackSwap com posicionamento.
`recommend_stack`	Stack inicial de referência para um setor vertical com custo por ferramenta, gasto total, pontuações de prontidão para IA e prontidão headless.

Comparar

Ferramenta	O que faz
`compare_tools`	Confronto direto: diferença de custo, prontidão para IA, prontidão headless (capacidade de chamada MCP/API), status de sobreposição e uma escolha recomendada com justificativa.
`compare_tools_n_way`	2 a 6 ferramentas lado a lado em uma matriz markdown — custo, prontidão para IA, prontidão headless, sobreposições dentro do conjunto, escolha do StackSwap.

Conteúdo

Ferramenta	O que faz
`search_content`	Busca de texto completo em ~50 artigos originais de operadores sobre arquitetura de stack, substituições nativas de IA, RevOps e frameworks de decisão.
`get_kb_article`	Busca o corpo completo de um artigo da base de conhecimento como markdown, com URL canônica, categoria e data da última modificação.

Categorias

Ferramenta	O que faz
`get_category_landscape`	Mapa completo de uma categoria de GTM — líderes, vice-líderes, candidatos a pular/substituir — com custo, prontidão para IA, status no registro de substituições por ferramenta.

Detectar

Ferramenta	O que faz
`detect_stack_from_text`	Infere uma stack de GTM a partir de texto livre (página de carreiras, anúncio de vaga, HTML do site, RFP, aba de rede do DevTools). Correspondências classificadas com níveis de confiança.

Suporte à decisão

Ferramenta	O que faz
`get_buyer_questions`	10 a 20 perguntas para fazer a um fornecedor antes de assinar, com "por que isso importa" e respostas de alerta. Armadilhas específicas do fornecedor quando você passa um fornecedor.
`get_renewal_strategy`	Playbook de negociação de renovação por fornecedor: pontos de alavancagem, alternativas de referência de preço, pedido de desconto calibrado, roteiro de saída, janela de tempo.

Escrever

Ferramenta	O que faz
`submit_correction`	Envia uma correção de catálogo (preços, funcionalidades, armadilhas, pontuações). Enfileirada para revisão administrativa — nunca propaga para superfícies voltadas ao usuário sem revisão.

Exemplos de uso

Uma vez instalado, pergunte qualquer uma das seguintes no seu cliente de IA e ele será roteado para a ferramenta certa:

Pergunta do operador	Ferramenta acionada
"Encontre uma ferramenta de cold email para mim"	`recommend_partner`
"Quanto custa o Smartlead?"	`get_tool_details`
"Smartlead vs Apollo para outbound?"	`compare_tools`
"Compare Smartlead, Instantly, Apollo e Lemlist"	`compare_tools_n_way`
"Mapeie toda a categoria de sales engagement"	`get_category_landscape`
"O que devo perguntar ao Apollo antes de assinar?"	`get_buyer_questions`
"Minha renovação do Salesforce é em 60 dias — qual é a minha alavancagem?"	`get_renewal_strategy`
"Qual stack esta empresa usa?" (cole uma página de carreiras)	`detect_stack_from_text`
"Quais sobreposições existem se eu uso HubSpot + Salesforce + Outreach?"	`find_overlaps`
"Audite minha stack: HubSpot, Salesforce, Outreach, ZoomInfo, Gong"	`scan_stack`
"Encontre o artigo do StackSwap sobre ética de dados em outbound"	`search_content`

As descrições das ferramentas são legíveis por modelos, então você não precisa saber os nomes das ferramentas — o modelo escolhe com base na pergunta.

Cliente de exemplo

Um exemplo mínimo em TypeScript que conecta, lista ferramentas e executa find_overlaps está em examples/client.ts.

npx tsx examples/client.ts

O protocolo é JSON-RPC 2.0 simples sobre HTTP — qualquer linguagem com um parser JSON e um cliente HTTP pode chamá-lo.

Detalhes do endpoint


URL JSON-RPC	`POST https://stackswap.ai/api/mcp`
Descritor do servidor	`GET https://stackswap.ai/api/mcp` (retorna nome, versão, lista de ferramentas)
Versões do protocolo	`2025-06-18`, `2025-03-26`, `2024-11-05`
Transporte	HTTP streamable, sem estado
Autenticação	Nenhuma
Limite de taxa	Nenhum (uso razoável)
CORS	`*`

Por que hospedado, não stdio

O servidor MCP do StackSwap roda dentro da aplicação Next.js existente do stackswap.ai como um único manipulador de rota. Hospedá-lo nós mesmos significa:

Sem atrito de instalação — uma linha claude mcp add, sem dependência npm/pip
Sempre atualizado — o catálogo de ferramentas subjacente, registro de sobreposições, fichas técnicas de fornecedores e dados de substituição são atualizados conforme o produto StackSwap evolui
Zero computação local — o motor de varredura roda no lado do servidor; os clientes apenas enviam JSON-RPC

A contrapartida: requer uma conexão com a internet, e nós (StackSwap) vemos o volume de requisições e padrões de chamada de ferramentas. Não armazenamos dados de conversa ou identificadores de usuário — o endpoint é sem estado.

Solicitações, problemas, feedback

Abra uma issue se você quiser que uma ferramenta seja adicionada, um comportamento alterado ou se encontrou um bug. A superfície MCP é moldada pelo que os operadores realmente perguntam.

Contato: [email protected]

Licença

MIT — veja LICENSE.

Esta licença cobre a documentação pública, esquemas JSON e clientes de exemplo neste repositório. Ela não cobre a implementação do servidor de código fechado que roda em stackswap.ai/api/mcp.