# Hotmart MCP for AI Agents AI Agent Connect > Hotmart MCP for managing digital products and online courses. Connect your Hotmart account to your AI client to track sales, monitor student progress, and manage memberships without leaving your workspace. It turns your course data into a conversational dashboard for real-time business insights. ## Overview - **Category:** ecommerce - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_77jKt1niFOVoEw3zKOtP9EtOna1YMeAiumAQTnP3/ai-agent-connect - **Tags:** digital-products, online-courses, subscription-management, sales-analytics, creator-economy, revenue-tracking ## Description Most creators spend way too much time in the back end of their platforms. You have to log in, find the right dashboard, filter by date, and then copy-paste numbers into a spreadsheet just to see if your last launch was successful. This Hotmart MCP changes that by letting you talk directly to your data. You can ask your AI client who's falling behind in your latest module or what your total revenue looked like last month. Instead of digging through complex dashboards, you get direct answers. You can see exactly which products are moving and which students need a nudge. It's like having a dedicated operations assistant that knows every detail of your digital storefront. You'll find it's a lot easier to spot trends or handle affiliate queries when the information is just one question away. You can get started quickly by connecting your credentials through the Vinkius catalog, giving your agent the context it needs to help you run your business. ## Tools ### get_sales_history Pull a list of all past transactions. This includes buyer details and commission breakdowns for your records. ### get_sales_summary Get a high-level overview of your total revenue. It shows sale counts and average ticket prices. ### get_student_progress Check how far a specific student has moved through your course content. This helps you identify who needs help. ### list_products See a full list of your live digital products. It shows current prices and their active status. ### list_students Get a complete list of all students enrolled in your memberships or courses. Use this to manage your community. ### list_subscriptions View all currently active subscriptions. It shows renewal dates so you can track recurring revenue. ## Prompt Examples **Prompt:** ``` What was my total revenue for the AI Mastery Course last month? ``` **Response:** ``` Here is the revenue summary for the **AI Mastery Course** for last month: * **Total Revenue:** R$ 48,230 * **Total Sales:** 312 * **Average Ticket:** R$ 154.58 Your top-performing product was the AI Mastery Course, accounting for 58.5% of your total monthly revenue. ``` **Prompt:** ``` Who is falling behind in the Python Bootcamp? ``` **Response:** ``` I've checked the progress for the **Python Bootcamp**. Here are the students who are currently falling behind (inactive for over 30 days): | Student Name | ID | Completion % | Last Activity | | :--- | :--- | :--- | :--- | | Maria Silva | student_891 | 12% | 45 days ago | | João Santos | student_902 | 8% | 38 days ago | | Ana Costa | student_915 | 22% | 35 days ago | Would you like me to send them a follow-up message? ``` **Prompt:** ``` List my active subscriptions and show me the last 3 sales. ``` **Response:** ``` ### Active Subscriptions There are **89** active subscriptions total. * **Monthly:** 52 (Avg R$ 49/mo) * **Annual:** 37 (Avg R$ 397/yr) * **Next renewals this week:** 8 ### Last 3 Sales 1. **AI Mastery Course** - R$ 297 (Approved) 2. **Data Science eBook** - R$ 47 (Approved) 3. **Python Bootcamp** - R$ 197 (Approved) ``` ## Capabilities ### Track student progress See exactly how far through a course your students have made it. ### Fetch sales history Pull a list of past transactions including buyer info and commissions. ### View revenue summaries Get high-level stats on total revenue and average ticket prices. ### Manage active subscriptions See who's currently paying for your memberships and when they renew. ### Audit product catalogs List every digital product you have live with its current price. ### Identify at-risk students Find out who hasn't logged in or completed a module recently. ## Use Cases ### Identifying drop-off points A creator asks who is falling behind in Module 4 and uses get_student_progress to see if they need to rewrite the content. ### Quick revenue checks A seller asks for the average ticket price of the last 50 sales using get_sales_summary to adjust their ad spend. ### Affiliate auditing A manager uses get_sales_history to cross-reference a specific buyer's commission with their affiliate's report. ### Student onboarding A teacher uses list_students to get a list of new signups to send a personalized welcome message. ## Benefits - Stop manual data entry. Use get_sales_summary to get your monthly numbers without exporting CSVs or clicking through multiple tabs. - Identify student churn early. Use get_student_progress to see who is falling behind and send them a personal nudge before they quit. - Handle affiliate audits faster. Use get_sales_history to quickly verify commissions and buyer information in one place. - Monitor your catalog status. Use list_products to keep a running eye on your live offerings and pricing across your entire store. - Manage membership renewals. Use list_subscriptions to see who is currently active and keep your recurring revenue on track. ## How It Works The bottom line is you get a conversational interface for your entire Hotmart business. 1. Subscribe to this Connector on Vinkius. 2. Input your Hotmart Client ID and Client Secret from your developer portal. 3. Ask your AI client questions about your sales or students to get instant data. ## Frequently Asked Questions **Can the Hotmart MCP show me my total sales?** Yes, it can pull a high-level revenue summary. You can ask your AI agent for total revenue, sale counts, and average ticket prices for any period. **How do I use the Hotmart MCP to see student progress?** You can ask your agent to check the progress of a specific student. It will show you their completion percentage and how far they've moved through your course. **Can I check my affiliate commissions with the Hotmart MCP?** Yes, the Connector can pull your sales history. This includes specific breakdowns for commissions on each transaction. **Does the Hotmart MCP work for membership renewals?** It does. You can list all active subscriptions to see who is currently paying and view upcoming renewal dates to track your recurring income. **How do I connect my Hotmart account to my AI agent?** You just need to subscribe to the Connector on Vinkius and enter your Hotmart Client ID and Client Secret from your developer portal. **Can the Hotmart MCP help me find students who haven't logged in?** Yes, you can use it to identify at-risk students. Your agent can pull a list of students and highlight those who are falling behind or haven't been active recently. **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.