Hotmart MCP. Manage sales, products, and subscriptions via API.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Hotmart. Manage your digital product sales, commissions, and subscriptions directly through the Hotmart API. This server gives your AI client tools to list products, track sales history, check commissions, and manage recurring subscriptions.
It's for automating the entire creator or e-commerce backend workflow.
What your AI agents can do
Get me
Gets the authenticated user's current profile information.
Get sale by user
Finds sales records associated with a specific user email address.
Get sales report
Retrieves a comprehensive sales report for the account.
Finds specific sales records and payment details tied to a user's email address.
Retrieves full, aggregated sales reports for period-end accounting or performance reviews.
Lists all active digital products and tracks the status of recurring subscriptions.
Retrieves lists of associated affiliates and calculates commission payouts for specific sales.
Lists all payments received and the associated sales history in one place.
Checks the list of configured webhooks and the authenticated user's profile information.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Hotmart MCP Server: 10 Tools for E-commerce Data
These tools let your AI client access Hotmart's core APIs to list products, track sales, manage subscriptions, and calculate commissions.
019d75b3get me
Gets the authenticated user's current profile information.
019d75b3get sale by user
Finds sales records associated with a specific user email address.
019d75b3get sales report
Retrieves a comprehensive sales report for the account.
019d75b3list affiliates
Lists all current affiliates for the products you sell.
019d75b3list commissions
Lists detailed commission payouts for recorded sales.
019d75b3list payments
Lists all payments received through the platform.
019d75b3list products
Lists every digital product available in your Hotmart account.
019d75b3list sales history
Provides a detailed list of all past sales transactions.
019d75b3list subscriptions
Lists all active and expired product subscriptions.
019d75b3list webhooks
Lists the webhooks that are currently configured for your account.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Hotmart, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Hotmart MCP Server gives your AI client direct access to your Hotmart business data. You'll use this server to automate core tasks—listing products, checking sales history, tracking commissions, and managing subscriptions—without ever touching the platform's dashboard. get_me gets your authenticated user's current profile info. list_products shows you every digital product you've got in Hotmart. list_affiliates lists all the affiliates you've signed up. list_sales_history gives you a detailed list of every past sale transaction. get_sale_by_user finds sales records tied to a specific user's email address. list_subscriptions tracks all active and expired product subscriptions. list_commissions shows detailed commission payouts for sales. list_payments lists every payment that's come through the platform. get_sales_report pulls a full sales report for your account. list_webhooks lists all the webhooks you've got configured for your account.
How Hotmart MCP Works
- 1 Tell your AI client the business question. For example: 'What were the commissions for sales in Q3?'
- 2 The agent selects the right tool, like
list_commissions, and passes necessary parameters (e.g., date range). - 3 The server executes the tool against the Hotmart API and returns structured data (JSON) to the agent for interpretation.
The bottom line is, your agent gets the raw, structured data it needs from Hotmart without you having to manually navigate any dashboards.
Who Is Hotmart MCP For?
Anyone running a digital product business or affiliate program. This is for the operations manager who spends too much time copying data from multiple dashboards into a spreadsheet. It's for the finance analyst who needs quick, auditable sales figures without calling support. It saves time by making the entire back-office process speak API language.
Uses list_products to confirm all active offerings are correctly registered and track changes in the product catalog.
Runs get_sales_report and list_payments to reconcile quarterly revenue and verify commission payouts against tax requirements.
Uses list_affiliates and list_commissions to quickly audit a specific partner's earnings and manage payout cycles.
What Changes When You Connect
- See every product and subscription status using
list_productsandlist_subscriptions. You instantly know what's selling and what's recurring, avoiding the need to manually check product pages. - Track specific revenue sources by running
get_sale_by_user. Instead of searching through massive transaction logs, you pull the exact sales data for one email address. - Run comprehensive financial audits by calling
get_sales_report. This tool gives you an aggregated view of performance data, far faster than exporting data into a spreadsheet. - Automate payout tracking with
list_commissionsandlist_affiliates. You don't have to manually cross-reference sale IDs with commission rules; the agent pulls the full payout list. - Maintain clean data by checking your configuration with
list_webhooks. You can confirm if the system is set up to notify other services when a sale happens. - Get a full picture of revenue flow by running
list_paymentsandlist_sales_historytogether. You see the money coming in and the full record of every transaction.
Real-World Use Cases
Auditing a Problematic Sale
A client emails, 'Where did my payment go?' Instead of having to ask an employee to manually look through sales records, your agent runs get_sale_by_user with the email. The agent gets the specific transaction details and relays the exact payment status to the user.
Quarterly Financial Reconciliation
The finance team needs to confirm Q3 revenue. They ask the agent to run get_sales_report and then list_commissions. The agent pulls the necessary data points, structures the total revenue, and provides a clean, auditable summary, cutting reconciliation time from hours to minutes.
Onboarding a New Affiliate
The affiliate coordinator needs to check the current payout structure. They run list_affiliates to see who's active and then list_commissions to verify the payout rates for a new product line. This confirms setup before any sales happen.
Checking Product Catalog Health
The Product Manager wants to ensure all their digital offerings are still live. They run list_products and then list_subscriptions to confirm that both the master catalog and the recurring revenue streams are accounted for and active.
The Tradeoffs
Manual Data Consolidation
Opening the sales dashboard, then opening the payments report, then opening the subscription list. Copying key numbers (total sales, MRR, total payments) into a spreadsheet to make sense of it.
→
Let your agent run get_sales_report and list_subscriptions sequentially. The agent combines the structured data from both tools, giving you a single, combined output that maps revenue against recurring revenue.
Guessing the Right Tool
Trying to determine if a sale is a one-time payment or a subscription payment by just looking at the raw sales history table, which mixes data types.
→
Use list_sales_history to get the transaction list, but then follow up with list_subscriptions to confirm if the specific sale ID is tied to an active recurring payment model.
Ignoring System State
Assuming a webhook is active because the feature is enabled in the UI, but failing to check if the endpoint is correctly configured or listed.
→
Run list_webhooks to get the definitive, current list of configured webhooks. This confirms the system's actual operational state, not just what the UI says.
When It Fits, When It Doesn't
Use this server if your core task is data retrieval, auditing, or automated reporting on sales, payments, or product status. You need to know what happened, when it happened, and who was involved. This is ideal for finance, operations, and affiliate management.
Don't use it if you need to create content (like writing emails or generating ads), or if you need to interact with features outside of sales tracking (e.g., updating user addresses). For those tasks, you'll need a messaging tool or a CRM-style API. The scope here is read-only data access and reporting.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Hotmart. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Manually reconciling sales and subscriptions is a nightmare.
Right now, getting a full picture of your revenue means jumping between the sales dashboard, the payments ledger, and the subscription management page. You copy transaction IDs, you cross-reference commission rates, and you spend hours in a spreadsheet trying to build a single source of truth.
With the Hotmart MCP Server, your agent runs `get_sales_report` and `list_subscriptions` together. It pulls the aggregated data, maps the MRR against total sales, and gives you a clean, single output that's ready for reporting.
Hotmart MCP Server: Track commissions and payments.
You no longer need to manually compare the total sales amount listed in the sales history against the expected payout amount for each affiliate. You simply ask the agent to run `list_affiliates` and `list_commissions`. The agent handles the join and presents the final, audited payout figures.
The difference is that the data doesn't just sit in a dashboard; it's instantly available and structured for your AI client. You get the answer, not the raw data dump.
Common Questions About Hotmart MCP
How do I use the `list_products` tool in the Hotmart MCP Server? +
The list_products tool gives you a list of every digital product registered in your account. It's the starting point if you need to confirm product IDs or check if a new product has been added.
Can I find a sale using `get_sale_by_user`? +
Yes. get_sale_by_user finds sales records by taking a specific user email as input. It's perfect for customer service agents who need to quickly verify a customer's purchase history.
Is `get_sales_report` better than `list_sales_history`? +
They serve different purposes. list_sales_history gives you a chronological list of every single transaction. get_sales_report gives you the summarized, aggregated data needed for high-level financial reporting.
What does `list_commissions` do? +
The list_commissions tool lists all commission payouts tied to sales. It's essential for tracking affiliate earnings and reconciling payouts for tax purposes.
Do I need to use `list_payments` and `list_subscriptions` together? +
It's helpful. list_payments shows the money that came through the gateway, while list_subscriptions shows the recurring status. Running both helps you track the full financial health of your recurring revenue.
How do I list the affiliates using the `list_affiliates` tool? +
The list_affiliates tool provides a comprehensive roster of every affiliate connected to your Hotmart account. It shows their details, commission status, and recent activity, letting you manage your partner network.
What is the purpose of the `list_webhooks` tool? +
The list_webhooks tool lets you see all the webhooks you've set up on your Hotmart account. You can check which events trigger which endpoints, which is key for reliable data syncing.
Does `list_subscriptions` handle recurring revenue data? +
Yes, list_subscriptions lists all active and past product subscriptions. You can track the number of recurring subscribers and estimate your Monthly Recurring Revenue (MRR) directly through the tool.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Duoplane
Equip your AI agent to manage multi-vendor orders, track purchase orders, and monitor vendor inventory via the Duoplane API.
Conekta
Equip your AI agent to securely manage Latin American payments, view transactions, and track sales using the Conekta API.
Correios do Brazil
Calculate shipping costs, estimate delivery times, and consult address information via the official Correios REST API.
You might also like
Shotstack
Render and edit videos programmatically with a cloud API that generates personalized video content at scale from templates.
Odoo Manufacturing
Create manufacturing orders, manage BOMs, work orders, and work centers — Odoo MRP through natural conversation.
Hootsuite (Social Media Management)
Manage social media via Hootsuite — schedule posts, manage social profiles, and monitor outbound messages.