Cakto MCP Server

Leitura de clientes na Cakto (para análise/CRM). Ações: - list: lista clientes (filtros: search, page). - get: perfil de UM cliente + histórico de compras (requer customer_id). [Flattened action: get] Bulk support: accepts customer_ids for batched execution.

Leitura de clientes na Cakto (para análise/CRM). Ações: - list: lista clientes (filtros: search, page). - get: perfil de UM cliente + histórico de compras (requer customer_id). [Flattened action: list] Bulk support: accepts customer_ids for batched execution.

Lista contas Cakto (apps do painel) vinculadas a este install — id, label e apelido.

Cria uma oferta (preço alternativo) para um produto existente na Cakto. É o passo necessário para ter o que oferecer num order bump com preço diferente do principal. Requer o escopo "write offers".

Leitura de ofertas na Cakto. A oferta é a unidade de PREÇO de um produto (cada produto nasce com uma oferta padrão) e é o alvo de um order bump — um bump aponta para uma OFERTA, nunca para o produto direto. Ações: - list: lista ofertas (filtros: product, status, type, search, ordering, limit, page). - get: detalhe de UMA oferta (requer offer_id). [Flattened action: get] Bulk support: accepts offer_ids for batched execution.

Leitura de ofertas na Cakto. A oferta é a unidade de PREÇO de um produto (cada produto nasce com uma oferta padrão) e é o alvo de um order bump — um bump aponta para uma OFERTA, nunca para o produto direto. Ações: - list: lista ofertas (filtros: product, status, type, search, ordering, limit, page). - get: detalhe de UMA oferta (requer offer_id). [Flattened action: list] Bulk support: accepts offer_ids for batched execution.

Atualiza uma oferta existente na Cakto (parcial: envie só o que muda). Use status="disabled" para desativar uma oferta sem apagá-la. Requer o escopo "write offers". Bulk support: accepts offer_ids for batched execution.

Cria um order bump: pendura uma OFERTA como oferta complementar no checkout de um produto. O produto (product_id) é o checkout onde o bump aparece; a oferta (offer_id) é o que está sendo oferecido — normalmente de OUTRO produto. Use cakto_offers (action=list) para descobrir o offer_id. Requer o escopo "write products". Bulk support: accepts product_ids, offer_ids for batched execution.

Leitura de order bumps (ofertas complementares exibidas no checkout). Ações: - list: lista os order bumps de UM produto (requer product_id). - get: detalhe de UM order bump (requer order_bump_id). [Flattened action: get] Bulk support: accepts product_ids, order_bump_ids for batched execution.

Leitura de order bumps (ofertas complementares exibidas no checkout). Ações: - list: lista os order bumps de UM produto (requer product_id). - get: detalhe de UM order bump (requer order_bump_id). [Flattened action: list] Bulk support: accepts product_ids, order_bump_ids for batched execution.

Reordena os order bumps de um produto numa chamada só: passe a lista completa de {order_bump_id, position}. Posição 1 aparece primeiro. Ids que não pertencem ao produto são ignorados pela Cakto. Requer o escopo "write products". Bulk support: accepts product_ids for batched execution.

Atualiza um order bump existente (parcial: envie só o que muda) — troca a oferta, o preço de referência, a copy ou a exibição da imagem. Requer o escopo "write products". Bulk support: accepts order_bump_ids, offer_ids for batched execution.

Analytics de vendas na Cakto: métricas financeiras agregadas por canal/campanha. Agrupe por group_by (utm_source|utm_medium|utm_campaign) e filtre por período (start_date/end_date no formato DD-MM-YYYY neste endpoint). Retorna gross_volume, net_value, total_fees, total_discount e order_count (valores como string, precisão decimal). Vendas sem UTM aparecem como "(unclassified)".

Leitura de pedidos na Cakto. Ações: - list: lista pedidos (filtros: status csv ex "paid,refunded", type unique|subscription, offer_type main|upsell|downsell|orderbump, payment_method, customer, product, paid_at_gte/paid_at_lt (YYYY-MM-DD), page). - get: detalhe de UM pedido (requer order_id). Retorna os dados crus da Cakto (paginação count/next/previous/results). [Flattened action: get] Bulk support: accepts order_ids for batched execution.

Leitura de pedidos na Cakto. Ações: - list: lista pedidos (filtros: status csv ex "paid,refunded", type unique|subscription, offer_type main|upsell|downsell|orderbump, payment_method, customer, product, paid_at_gte/paid_at_lt (YYYY-MM-DD), page). - get: detalhe de UM pedido (requer order_id). Retorna os dados crus da Cakto (paginação count/next/previous/results). [Flattened action: list] Bulk support: accepts order_ids for batched execution.

Lista produtos da conta na Cakto (paginado: count/next/previous/results). Filtros opcionais: search, product_id (um id ou vários separados por vírgula — é assim que se lê UM produto específico), status, type, ordering, limit, page. Bulk support: accepts product_ids for batched execution.

Cria um produto na Cakto. A criação já gera automaticamente a oferta padrão e o checkout do produto (não existe endpoint separado de criar checkout). Requer o escopo "write products" no app do Painel Cakto.

Atualiza um produto existente na Cakto. A atualização é PARCIAL: envie só os campos que quer alterar. Use status="blocked" para tirar o produto de circulação sem apagá-lo. Requer o escopo "write products". Bulk support: accepts product_ids for batched execution.

Assinaturas perdidas: lista canceladas/inativas do negócio + métricas agregadas (valor em risco, nº de clientes afetados). Filtros de período opcionais.

Leitura de assinaturas na Cakto. Ações: - list: lista assinaturas (filtros: status, payment_method, current_situation new|renewed, search, ordering, limit, page). - get: detalhe de UMA assinatura (requer subscription_id). [Flattened action: get] Bulk support: accepts subscription_ids for batched execution.

Leitura de assinaturas na Cakto. Ações: - list: lista assinaturas (filtros: status, payment_method, current_situation new|renewed, search, ordering, limit, page). - get: detalhe de UMA assinatura (requer subscription_id). [Flattened action: list] Bulk support: accepts subscription_ids for batched execution.

MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link.

Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.

The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/<slug> link that opens without login.

Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

Show the current MCP platform and adapter versions.

Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.