Nenhuma ferramenta desta página precisa de Chave de API. Elas leem só
material público — o contrato da API (o mesmo schema que gera esta
documentação) e as páginas desta documentação — por isso funcionam mesmo
antes de você configurar qualquer credencial.
cakto_search_api
Busca endpoints por intenção, em português ou inglês. É o ponto de entrada
quando a IA (ou você) não sabe o nome exato da operação.
Exemplo:
operation_id, método, path
e resumo de cada operação candidata — pronta para ser detalhada com
cakto_get_endpoint.
cakto_list_endpoints
Lista o catálogo completo de operações disponíveis, agrupado por recurso
(produtos, ofertas, pedidos, assinaturas, webhooks, clientes, pagamentos,
checkouts, order bumps). Útil para ter uma visão geral do que a API
oferece, ou quando a busca não encontra nada relevante.
Esta lista reflete só as operações realmente documentadas no contrato da
API. Ela nunca inclui algo que não esteja confirmado no contrato — a IA
não inventa cobertura que a API não tem.
cakto_get_endpoint
A ferramenta mais importante da descoberta: o contrato completo de uma
operação específica. É sempre chamada antes de qualquer execução — a IA
nunca monta um payload por adivinhação.
Retorna, para a operação pedida:
- Método, URL completa e caminho
- Parâmetros de path e query — tipo, obrigatoriedade, enum, valor default
- Schema completo do corpo da requisição, com cada campo documentado
- Schema de cada resposta possível, com um exemplo gerado a partir do contrato (nunca um dado que pareça real)
- Se o campo não estiver documentado no contrato, a ferramenta diz isso explicitamente em vez de inventar um valor
cakto_list_webhook_events
Catálogo de eventos de webhook disponíveis — nome do evento e se ele é
efetivamente testável pela API. Use quando for configurar um webhook, ou
para investigar por que um evento esperado não chegou.
Sem parâmetros.
cakto_search_docs
Busca nesta documentação por título e descrição — conceitos, guias de início,
SDK do checkout, referência de API e as páginas do próprio CaktoMCP. É o
catálogo: é aqui que a IA descobre qual página existe antes de pedir o texto.
cakto_get_guide
Lê uma página inteira desta documentação, pelo slug — para dúvida de
conceito (autenticação, idempotência, paginação, tratamento de erro,
webhooks, ambientes, Checkout Builder, SDK), em vez do contrato de um
endpoint específico.
Estas duas ferramentas leem a documentação publicada, em tempo de
execução: não existe cópia dos textos dentro do servidor, então a resposta
da IA acompanha o que está no ar. Como funciona, e o que fazer quando o slug
não é conhecido, em Guias.
Próximos passos
Ferramentas de Execução
Como funciona a execução real, com credencial
Guias
Como o MCP lê esta documentação em tempo real