# Hotmart MCP for AI Agents AI Agent Connect > Hotmart MCP lets your AI client handle your digital product sales, manage recurring subscriptions, and track affiliate performance automatically. It connects directly to your Hotmart account so your agent can pull sales reports, list products, or monitor webhooks without you having to jump between tabs. It's built for creators who want to automate the back-office side of their online business and get real-time data on their revenue and customer base. ## Overview - **Category:** ecommerce - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_U8LSzRXNFjj9eW399BeFD1e0qAH6DMMLbbWft2s4/ai-agent-connect - **Tags:** digital-products, online-courses, subscription-management, sales-analytics, creator-economy, revenue-tracking ## Description Selling digital products means spending a lot of time in the weeds of backend management. You have to check who is subscribed, figure out which affiliates are actually driving traffic, and keep an eye on your sales reports to see what is moving. It is a lot of manual clicking that pulls you away from actually creating content or growing your brand. This Connector changes that by giving your AI agent the keys to your Hotmart account. Instead of logging in to manually export CSVs or hunt for specific customer emails, you can just ask your agent to do the heavy lifting. Whether you need to see a breakdown of your latest commissions or want to check the status of your webhooks, the agent handles the data fetching for you. It is about moving from admin mode back into creator mode. By using this through the Vinkius catalog, you get a centralized way to manage your entire digital storefront. You can audit your sales history, manage your product list, and keep track of your recurring revenue all in one conversation. It is less about integrating an API and more about having a teammate who knows exactly where your sales data lives and can grab it whenever you need it. ## Tools ### get_sales_history Get sales history ### get_sales_summary Get sales summary ### get_student_progress Get progress for a student ### list_products Get a complete list of every product in your Hotmart account. Use this to manage your active catalog. ### list_students List students (members) ### list_subscriptions See all your active and past recurring subscriptions. It makes managing memberships much easier. ## Prompt Examples **Prompt:** ``` How many sales did I make yesterday? ``` **Response:** ``` I've pulled your sales history from yesterday. You had 12 successful transactions totaling $1,450.00. Your top product was 'Advanced Copywriting Masterclass'. ``` **Prompt:** ``` Who are my top affiliates? ``` **Response:** ``` I've analyzed your commission data. Here are your top 3 affiliates based on volume: | Rank | Affiliate Name | Total Sales | |---|---|---| | 1 | Sarah J. | 45 | | 2 | TechReviews | 32 | | 3 | Mark Media | 28 | ``` **Prompt:** ``` Are my webhooks still active? ``` **Response:** ``` I've checked your webhook configurations. You have 3 active webhooks: - Sale Notification - Subscription Update - Refund Trigger Everything looks like it is running correctly. ``` ## Capabilities ### Pull sales reports Get a high-level look at your revenue and performance data instantly. ### Track affiliate performance See which partners are driving the most traffic to your products. ### Manage recurring subscriptions View and organize all your active and past subscription records. ### Audit sales history Look back through past transactions to find specific customer details. ### Monitor webhooks Check the status of your automated data triggers. ### Fetch product details Get a full list of everything you are currently selling. ## Use Cases ### Tracking Affiliate Success An affiliate manager wants to see who is actually making money. They ask the agent to list commissions and identify the top earners. ### Subscription Auditing A membership owner wants to know how many people canceled today. They use the agent to check the list of subscriptions. ### Customer Support Lookup A creator gets an email from a confused buyer. They ask the agent to find the sale by user email to see what was purchased. ### Product Catalog Review A seller wants to see all their active products to plan a sale. They ask the agent to list products and check current status. ## Benefits - Stop manual data entry by having your agent pull sales reports and commission lists automatically. - Monitor your recurring revenue more accurately by using list_subscriptions to see your active member base. - Quickly identify your best partners by using list_affiliates to audit your entire affiliate network. - Save time on customer support by using get_sale_by_user to find specific purchase history via email. - Ensure your automations stay live by checking your configured webhooks to see if they are active. - Keep your product catalog organized by using list_products to see exactly what is currently live. ## How It Works The bottom line is you stop manually checking dashboards and start getting answers instantly. 1. Connect your Hotmart API credentials to your AI client via the Vinkius platform. 2. Ask your agent to perform a specific task, like pulling a commission report or listing products. 3. Receive a formatted summary or data set directly in your chat interface. ## Frequently Asked Questions **Can the Hotmart MCP help me track my earnings?** Yes, it lets your agent pull commission lists and sales reports so you can see exactly how much you are making in real-time. **Can I use this to see who my affiliates are?** Absolutely. You can ask your agent to list your affiliates to see who is promoting your products. **Does this Connector show my subscription data?** It does. You can use it to see a full list of your active and past recurring subscriptions. **Can I find a specific customer's purchase?** Yes, you can ask your agent to find a sale by a user's email address to see what they bought. **Can I see what products I am selling?** Yes, your agent can pull a full list of all the products currently registered in your Hotmart account. **Can I check if my automations are still working?** You can use the Connector to list your configured webhooks to ensure your external systems are still receiving data. **Does this Connector manage my actual product pages?** No, it is for managing the data. You can see your products and sales, but you will not edit the public-facing landing pages. **How do I get my Hotmart API credentials?** You can find your Client ID and Client Secret in the Hotmart Developers platform under 'Credentials'. **Can I track affiliate sales?** Yes, the list_affiliates and list_sales_history tools allow you to monitor affiliate performance. **Is the sales report real-time?** Yes, all data is retrieved directly from Hotmart's servers in real-time. **Can I track how many students completed my course?** Yes. Use `list_students` to see all enrolled students across your products. Then use `get_student_progress` with a Student ID to see their course completion percentage, modules accessed, and last activity date. This helps identify students at risk of dropping off. **Does Hotmart require two credentials for authentication?** Yes. Hotmart uses OAuth 2.0 Client Credentials flow. You need a **Client ID** and a **Client Secret**, generated in the Hotmart Developer Portal. These are used to obtain a Bearer token automatically — the server handles token exchange internally. **Can I view a detailed breakdown of my sales revenue?** Yes. Use `get_sales_summary` for aggregated data including total revenue, number of sales, and average ticket. Use `get_sales_history` for individual transactions with status, price breakdowns, commissions, and buyer information. Combine with `list_products` to correlate revenue per product.