How to Use the Hotmart MCP in Claude

Q: How do I connect the Hotmart MCP Server to Claude Desktop?

Open your claudedesktopconfig.json file and add the server configuration under the mcpServers key. Restart your Claude Desktop app, and you will see the new tools available via the hammer icon in your chat window.

Q: Can I filter affiliate lists in Claude Desktop?

Yes, your agent uses the listaffiliates tool to fetch your partner database directly. You can then ask the chat client to filter, sort, or group those affiliates by performance.

Run the Hotmart MCP Server locally or on the web to pull affiliate payouts and sales logs directly into your Claude Desktop chat.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Hotmart MCP to Claude Desktop

Create your Vinkius account to connect Hotmart to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Hotmart with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Query sales history directly from Claude Desktop

The Hotmart MCP Server exposes the `list_sales_history` tool so your Claude Desktop client can pull raw transaction records without you leaving the chat. Your agent reads the raw purchase logs, filters by date, and identifies which products drive your daily revenue. You don't need to manually export CSVs from your creator dashboard anymore. Just ask your AI client to run `get_sales_report` to compile your monthly numbers or use `get_sale_by_user` to find a customer's specific purchase details using their email.

Audit affiliate payouts inside your workspace

The `list_affiliates` tool gives your Claude Desktop agent direct access to your affiliate network data. Your AI client pulls active partner lists and cross-references them with raw commission logs to verify payouts. By calling `list_commissions` alongside `list_payments`, your agent spots discrepancies in affiliate payouts before they hit your bank account. You get a clear view of your distribution pipeline without clicking through multiple dashboard tabs.

Monitor active subscriptions and webhook configurations

The `list_subscriptions` tool lets your Claude Desktop client inspect recurring customer payments. Your agent checks subscription statuses, tracks renewals, and flags failed payments immediately. You can also command the agent to run `list_webhooks` to verify that your external integrations receive real-time event notifications. This keeps your delivery systems aligned with active customer states.

Setup guide

Set up Hotmart MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Hotmart MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Hotmart MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under hotmart-mcp.

json

{
  "mcpServers": {
    "hotmart-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Hotmart now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Hotmart MCP in Claude Desktop

Open your `claude_desktop_config.json` file and add the server configuration under the `mcpServers` key. Restart your Claude Desktop app, and you will see the new tools available via the hammer icon in your chat window.

Yes, you can add this remote server directly in your browser under Settings and then Integrations on Claude.ai. This lets your web agent run queries like `list_products` without running any local terminal commands.

Your local configuration manages the execution of tools like `list_sales_history` to prevent hitting API bottlenecks. If you run high-volume queries, Claude Desktop processes the responses sequentially to respect your API quotas.

Yes, your agent uses the `list_affiliates` tool to fetch your partner database directly. You can then ask the chat client to filter, sort, or group those affiliates by performance.

Your raw sales history, customer emails, and webhook logs stay local when running the desktop app with this MCP Server. No transaction data gets stored on external servers, keeping your financial metrics completely private.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript