# Kiwify MCP MCP > Kiwify MCP lets you manage digital product sales and online course revenue directly through conversation. Connect your Kiwify account to any AI agent to track active subscriptions, analyze detailed sales history, and monitor customer engagement across the Brazilian market. This connector handles everything from basic order tracking to complex MRR calculations. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** digital-products, online-courses, order-management, subscription-tracking, revenue-analytics, affiliate-management ## Description When running a business selling digital goods or courses, you constantly need an accurate view of your revenue streams, but that data is scattered across dashboards, reports, and spreadsheets. This MCP connects all those dots for you. You'll manage product listings, check current sales performance, and drill down into individual transactions using natural conversation. It tracks everything from initial purchases to recurring subscriptions, giving you a full picture of your business health. If you use Vinkius, this Kiwify MCP plugs right into your existing AI client, letting you query all that financial data without ever leaving your chat window. You can also manage the system's underlying infrastructure by setting up and monitoring webhooks. ## Tools ### create_notification_webhook Sets up a new webhook URL so Kiwify can send automated notifications to an external service. ### delete_notification_webhook Removes an existing, unnecessary webhook endpoint from your account. ### get_account_summary Retrieves a high-level overview of key account metrics and sales totals. ### get_product_details Fetches specific information, pricing, and description details for one product ID. ### get_sale_details Retrieves complete information about a single transaction or sale event. ### list_products Lists every product available in your Kiwify catalog, including their current sales status. ### list_sales_history Pulls a filtered list of recent transactions and overall sales activity over time. ### list_active_subscriptions Generates a list of all currently running and paid-up recurring subscriptions. ### list_configured_webhooks Displays all webhook URLs that are currently active on your Kiwify account. ## Prompt Examples **Prompt:** ``` Show all products with sales performance and today's orders. ``` **Response:** ``` Products: 5. 'Marketing Digital Pro' (R$497, 1.2K sales, R$596K total). 'SEO Masterclass' (R$297, 890 sales, R$264K). 'Social Media Kit' (R$97, 2.1K sales, R$204K). Today: 8 orders. 3 'Marketing Digital Pro', 2 'SEO', 3 'Social Media'. Revenue today: R$2,582. Refunds: 0. ``` **Prompt:** ``` Show active subscriptions and churn rate for this month. ``` **Response:** ``` Active subscriptions: 342. 'Marketing Digital Pro Monthly' (180, R$97/mo). 'SEO Membership' (120, R$67/mo). 'All Access' (42, R$197/mo). MRR: R$33,054. This month: +28 new, -12 cancelled. Churn rate: 3.5% (industry avg: 5-7%). Upcoming renewals: 45 in next 7 days. ``` **Prompt:** ``` Show the customer database and top buyers. ``` **Response:** ``` Customers: 4,190 total. This month: +248 new. Top by lifetime value: 1) João Silva — R$2,388 (All Access + courses). 2) Maria Santos — R$1,594 (3 products). 3) Carlos Mendes — R$1,291 (2 products + subscription). Average LTV: R$253. Repeat buyers: 18%. ``` ## Capabilities ### Monitor subscription revenue List active memberships, track renewal dates, and determine monthly recurring revenue (MRR). ### Analyze sales transactions Pull detailed records of past sales and current orders by filtering transaction history. ### Inspect product details Get specific information about any listed digital course or product. ### View customer accounts List customers and review their complete purchase history within the system. ### Manage platform webhooks Create, read, and delete webhook endpoints to automate notifications from Kiwify. ## Use Cases ### Calculating Monthly Recurring Revenue (MRR) A founder needs to know the MRR and churn rate right now. They ask their agent, which uses `list_active_subscriptions`, and immediately gets a breakdown of active memberships, renewal counts, and the percentage of users who cancelled this month. ### Investigating a Missing Sale A customer reports a payment didn't go through. You ask your agent to check the `list_sales_history` for that date range and then use `get_sale_details` on the suspected transaction ID, confirming exactly what happened. ### Auditing Product Status You suspect a product listing is mispriced. You ask your agent to run `list_products`, find the problematic item's name, and then use `get_product_details` to verify its current settings. ### Setting up Failure Alerts Your team needs to be notified immediately if a refund over $500 occurs. You first run the tools to confirm webhook functionality, then use `create_notification_webhook` to set up the precise alert. ## Benefits - Stop manually cross-referencing data. By using the `list_sales_history` tool, your agent aggregates all transactions—refunds, sales, and amounts—into one conversational summary. - Monitor subscription health instantly. You can call `list_active_subscriptions` to see how many users are paying monthly and calculate immediate MRR without opening a billing dashboard. - Analyze customer behavior deeply. Instead of just seeing an order ID, you use the tools to pull full purchase histories for any user, helping you target high-value clients with upsell offers. - Automate system alerts. You can manage your infrastructure by using `create_notification_webhook` so that key events (like a large refund) trigger immediate messages or actions elsewhere. - Get product data on demand. If you need to know the pricing or details of an old course, calling `get_product_details` gives you instant reference material for your AI agent. ## How It Works The bottom line is, you talk to your AI client, and it talks to Kiwify for you. 1. Subscribe to the MCP and input your unique Kiwify Access Token and Account ID. 2. Your AI client authenticates with Vinkius, establishing a direct channel to Kiwify's data layer. 3. You prompt your agent in natural language (e.g., 'What was last month's churn rate?'), and the MCP executes the necessary tool calls and returns structured results. ## Frequently Asked Questions **How do I check sales data using list_sales_history?** You ask your agent to run `list_sales_history` and specify the date range or product type. This returns a filtered list of transactions, letting you see exactly what happened during that time. **Can I use get_product_details for pricing information?** Yes. You run `get_product_details` and provide the product ID. This instantly retrieves all current details, including the listed price and any promotional info, without you navigating the Kiwify UI. **What is the purpose of create_notification_webhook?** You use `create_notification_webhook` when you need an automated system alert. It sets up a reliable data endpoint so that other services can automatically react to events, like a new sale or a refund. **Does list_products give me sales performance?** It lists all available products in your catalog. For specific sales performance metrics (like total revenue over time), you'll need to run `list_sales_history` and filter by the product name. **How do I check customer purchase history?** You use the available tools that access customer data. If you have a specific ID, you can review their complete record to see all purchases they've made on your site. **What kind of overall data do I get when I run `get_account_summary`?** This tool delivers a high-level snapshot of your entire Kiwify account. You'll see aggregate details like total sales volume, the number of active products you manage, and key operational metrics all in one place. **How do I clean up old integrations using `list_configured_webhooks` and then remove them with `delete_notification_webhook`?** First, use `list_configured_webhooks` to see every active endpoint connected. If you find an unused or obsolete webhook, running `delete_notification_webhook` removes it entirely, preventing unnecessary data flow. **When I run `list_active_subscriptions`, what recurring revenue metrics can I pull?** This function provides a detailed breakdown of your Monthly Recurring Revenue (MRR) and churn rate. It tells you exactly how many users are paying, which subscription plans they're on, and when renewals are scheduled. **Can I track orders and revenue performance?** Yes. Browse all orders with status (approved, refunded, pending), amounts, and customer data. Track revenue metrics and trends. **Can I monitor subscriptions and churn?** Yes. Track active subscriptions, upcoming renewals, cancellations, and churn rates across all products. **Does Kiwify require two credentials?** Yes. Kiwify requires an **Access Token** and **Account ID**. Bearer authentication against `public-api.kiwify.com/v1`.