Subtraq

npx add-mcp 'https://subtraq.co/api/mcp'

Um endpoint, oito ferramentas, e seu agente sabe o que vendeu.

Seu agente já fala MCP. O nosso é um endpoint, oito ferramentas e autenticação por chave de API — o protocolo cuida do resto. Você abre o workspace no plano gratuito, sem cartão de crédito.

Três letras, zero SDK

MCP

O protocolo para seus agentes de IA

Model Context Protocol: o plugue padrão entre um agente e uma ferramenta. Nenhuma biblioteca para instalar, nenhum wrapper para manter — uma URL, uma chave, e o agente descobre as ferramentas sozinho.

O que o agente controla, em capturas de tela

8 ferramentas expostas ao agente

Esta lista é importada do registro que o servidor realmente expõe — quando uma ferramenta muda, esta página muda junto.

list_spaces

Lista os workspaces da conta. Um workspace = um cliente, marca ou projeto; todo o resto (links, cliques, vendas) vive dentro dele.

create_space

Cria um workspace de cliente. Recusado com o código space\_limit\_reached\ quando o plano está cheio.

list_links

Lista links. Um link PARENT carrega o destino; um PLACEMENT (sublink) carrega os UTMs de um post específico e herda o restante.

create_link

Cria um link curto. Sem parentId\ é um link parent e destination\ é obrigatório. Com parentId\ é um placement: ele herda o destino do parent e carrega seus próprios UTMs. Retorna shortUrl\, pronto para publicar.

get_link

Detalha um link: seu destino FINAL (UTMs incluídos, exatamente como o site de destino o recebe) e seus cliques em 30 dias.

update_link

Altera o destino, o rótulo ou o ENDEREÇO de um link (domain\ e/ou slug\), ou o arquiva. Alterar o endereço não quebra nada: o endereço antigo continua redirecionando para o mesmo lugar e seus cliques contam neste link (previousShortUrls\); placements que compartilhavam o domínio o seguem. Um link NUNCA é excluído: arquivado, ele para de redirecionar (endereços antigos incluídos), mas seu histórico permanece.

get_analytics

Os números de um workspace: cliques, leads, vendas, receita ATRIBUÍDA e receita NÃO ATRIBUÍDA, além do detalhamento placement por placement. Valores em CENTAVOS. Subtraq não converte moedas: se mixedCurrencies\ for verdadeiro, os totais cobrem apenas currency\. model\ define como a atribuição é lida; a resposta sempre informa qual foi usada.

track_sale

Registra uma VENDA e a vincula ao placement de origem da pessoa. Valor em CENTAVOS. invoiceId\ torna a chamada idempotente: repeti-la nunca cobra duas vezes. Uma venda NÃO pode ser enviada de um navegador.

Três tarefas. O agente lida melhor com elas.

O link no meio da conversa

"Crie um link para a página promocional, canal newsletter, workspace Lartigue" — o agente chama create_link e insere a URL curta no seu rascunho.

Resumo de segunda de manhã

"O que gerou receita esta semana, cliente por cliente?" — o agente encadeia list_spaces e get_analytics e responde em linguagem simples, não em tabela.

A venda offline

Um contrato assinado por telefone? "Registre $2.400 para o link do estande" — track_sale, e a atribuição está completa.

O que o agente lê: atribuição e ROAS

Uma API documentada em OpenAPI

O servidor MCP e a API v1 compartilham o mesmo registro: oito ferramentas, uma verdade. Seus scripts existentes usam a API; seus agentes usam o MCP; ninguém fica esperando outra "integração de IA".

GET /api/v1/openapi.json

O contrato completo, gerado a partir do mesmo registro de ferramentas. O que o MCP expõe, a API expõe — nunca um sem o outro.

8

ferramentas, idênticas entre MCP e API

1

chave de API — a mesma para ambos

0

SDK para instalar no lado do agente

Perguntas frequentes

Com quais agentes ele funciona?

Qualquer cliente MCP: Claude (Desktop e Code) e qualquer outro cliente compatível com o protocolo. O servidor fala MCP padrão — initialize, tools/list, tools/call — sem extensão proprietária.

Um agente pode quebrar algo?

Ele faz exatamente o que sua chave de API permite, dentro do workspace daquela chave. Nenhuma exclusão em massa exposta: as ferramentas criam, leem e atualizam. Cada chamada é registrada como qualquer chamada normal de API.

Qual plano inclui isso?

A API e o MCP estão vinculados à chave de API do seu workspace. A criação de chaves está disponível no produto — os limites do seu plano se aplicam aos links criados, independentemente de onde venham.

Por que um encurtador precisa de MCP?

Porque o trabalho em torno de links é conversacional: você escreve um boletim, prepara uma campanha, faz uma revisão de cliente. O agente já está na conversa — ele pode muito bem criar os links e ler os números sem trocar de aba.