# Kiwify — how to use (mcp.ai)

Plataforma de produtos digitais Kiwify, vendas (listar, detalhar), assinaturas (listar, cancelar), produtos e afiliados via API oficial. Gere suas credenciais (API Key + Client Secret) e copie seu Account ID em Configurações → API no painel Kiwify.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_kiwify?ms=1781045100000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `kiwify_affiliates`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/kiwify`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/kiwify/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/kiwify/affiliates` — Lista afiliados do creator na Kiwify (filtros opcionais: status, page_size, page).
  - body: { status?: string, page_size?: integer, page?: integer, account?: string }
- `POST https://api.mcp.ai/api/kiwify/list/accounts` — Lista contas Kiwify (creators) vinculadas a este install — id, label e apelido.
  - body: { account?: string }
- `POST https://api.mcp.ai/api/kiwify/products` — Lista produtos do creator na Kiwify (filtros opcionais: page_size, page).
  - body: { page_size?: integer, page?: integer, account?: string }
- `POST https://api.mcp.ai/api/kiwify/sales/get` — Leitura de vendas na Kiwify.
  - body: { sale_id?: string, start_date?: string, end_date?: string, product_id?: string, status?: string, page_size?: integer, page?: integer, account?: string, sale_ids?: string[], product_ids?: string[] }
- `POST https://api.mcp.ai/api/kiwify/sales/list` — Leitura de vendas na Kiwify.
  - body: { sale_id?: string, start_date?: string, end_date?: string, product_id?: string, status?: string, page_size?: integer, page?: integer, account?: string, sale_ids?: string[], product_ids?: string[] }
- `POST https://api.mcp.ai/api/kiwify/subscriptions/get` — Leitura de assinaturas na Kiwify.
  - body: { subscription_id?: string, product_id?: string, status?: string, page_size?: integer, page?: integer, account?: string, subscription_ids?: string[], product_ids?: string[] }
- `POST https://api.mcp.ai/api/kiwify/subscriptions/list` — Leitura de assinaturas na Kiwify.
  - body: { subscription_id?: string, product_id?: string, status?: string, page_size?: integer, page?: integer, account?: string, subscription_ids?: string[], product_ids?: string[] }
- `POST https://api.mcp.ai/api/kiwify/subscriptions/write/cancel` — Mutações em assinaturas Kiwify.
  - body: { subscription_id: string, account?: string, subscription_ids?: string[] }

## Example prompts
- "Quanto vendi na Kiwify nos últimos 30 dias?"
- "Liste minhas assinaturas ativas"
- "Cancele a assinatura subscription_id X"

## More
- Page: https://mcp.ai/kiwify
- Agent spec (llms.txt): https://mcp.ai/kiwify/llms.txt
- Postman collection: https://mcp.ai/kiwify/postman.json