# Hotmart MCP > Hotmart MCP handles all operational data for digital products and subscriptions. Use this to pull comprehensive sales reports, track recurring revenue streams, monitor affiliate payouts, and manage product inventory directly through your AI client. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** digital-products, affiliate-marketing, commissions, sales-tracking, subscription-management ## Description This connector lets you build a full picture of your digital business without logging into the Hotmart dashboard. Instead of juggling multiple tabs just to figure out last month's commissions or today's signups, you tell your agent what you need, and it pulls the data instantly. You can get a detailed sales report that covers everything from basic transaction records to complex recurring revenue figures for specific products. It’s perfect for automating creator workflows and managing subscription lifecycles. Through Vinkius, you connect once and gain access to this full suite of Hotmart tools, letting your AI client handle the heavy lifting—whether it's finding a sale associated with an email or listing all active products. You get clear, actionable data every time. ## Tools ### get_me Retrieves the basic account information for the user who is connected. ### get_sale_by_user Locates any sales record based on a specific customer's email address. ### get_sales_report Pulls together an overall, comprehensive report detailing all recent sales activity. ### list_affiliates Provides a full roster of every affiliate registered for your products. ### list_commissions Lists all commission payouts associated with completed sales transactions. ### list_payments Retrieves a log of all payments that have been successfully received by your account. ### list_products Lists every digital product currently registered in the Hotmart marketplace. ### list_sales_history Provides a detailed chronological list of all sales that have occurred. ### list_subscriptions Shows details about active and inactive product subscriptions for your user base. ### list_webhooks Displays all webhooks that have been configured to notify external services of events. ## Prompt Examples **Prompt:** ``` Show me the last 10 sales in my Hotmart account. ``` **Response:** ``` I've pulled the recent sales data. Over the last 10 transactions, you've accumulated $425.50 in net commissions. Your top-selling product was 'Advanced AI Prompting Course' with 6 conversions this week alone. ``` **Prompt:** ``` List all my products on Hotmart. ``` **Response:** ``` You have 3 active digital products registered: 1. 'Masterclass SEO' (ID: 99120), 2. 'Email Templates' (ID: 99144), 3. 'Consulting Calls' (ID: 99201). Let me know if you would like me to list their individual conversion rates. ``` **Prompt:** ``` Check for active subscriptions. ``` **Response:** ``` Scanning subscriptions... You currently stand at 145 active recurring subscribers, generating approximately $2,900 MRR. There were 2 new signups today and 1 cancellation. ``` ## Capabilities ### Monitor Sales Performance Generate full sales reports and review detailed transaction logs to understand revenue trends. ### Manage Subscriptions & Products Get a complete list of all digital products, track product subscriptions, and monitor your user base's activity. ### Track Financial Payouts List payments received, check commission payouts across sales, and identify active affiliates to reconcile accounts. ### Analyze User Transactions Find specific sale records by entering a user's email address for quick account checks. ## Use Cases ### Auditing Commission Discrepancies The finance analyst noticed a discrepancy in the quarterly payout. They ask their agent to cross-reference list_payments with list_commissions, immediately isolating the missing sale records and identifying the exact gap. ### Checking Product Availability A product manager needs to know if they can launch a bundle discount. They run list_products first, verifying that all necessary items are active before proceeding with marketing copy. ### Analyzing Customer Lifetime Value The sales team wants to assess the value of high-value customers. They use get_sale_by_user on a list of premium emails, pulling all associated transactions and subscription details for review. ### Verifying Partner Status A marketing coordinator needs to know who is eligible for a bonus payout. They run list_affiliates, quickly getting the names and statuses of every partner they need to contact. ## Benefits - Stop manually compiling sales data. Use list_sales_history to get an instant log of every transaction, letting your agent summarize the key takeaways for you. - Keep tabs on recurring revenue without logging into a dashboard. Running list_subscriptions gives you immediate insight into your active subscriber count and MRR potential. - Reconcile payouts faster than ever. You can run list_commissions against list_payments to ensure every dollar earned is accounted for, reducing accounting friction. - Manage product updates through the AI. Run list_products first to see all current items before drafting a new launch plan or checking if an old item needs deactivation. - Deep-dive into user finances. Need to know what happened with one client? Use get_sale_by_user to pinpoint their exact transaction history by email. ## How It Works The bottom line is you don't have to copy-paste data between dashboards; your AI client does it for you in one go. 1. First, you tell your AI client the business question: 'What were my commissions last quarter?' 2. The agent invokes the necessary tools—like listing payments and getting sales reports—to gather all relevant raw data. 3. You get back a single, consolidated answer from your agent containing all the figures and details needed to make a decision. ## Frequently Asked Questions **Can Hotmart MCP find my sales by email?** Yes, absolutely. Use get_sale_by_user to pinpoint specific transactions instantly just by knowing the customer's email address. **Does list_products include retired items?** The tool lists all products registered in your account. Always verify if you need to run list_webhooks after listing products, as changes might trigger updates. **How do I check my affiliate payments?** Use list_affiliates to see who is eligible for commissions, and then run list_commissions to view the actual payout amounts associated with sales history. **Is get_sales_report limited to only transactions?** No. While it captures general sales data, you should also use list_subscriptions for a complete picture of recurring revenue status beyond single transactions. **Can I see all payments received at once with Hotmart MCP?** Yes, run list_payments to retrieve a comprehensive log of every payment that has successfully been sent and recorded in your account.