How to Use the Hotmart MCP in Windsurf

Q: How do I install the Hotmart MCP Server in Windsurf?

Open your mcpconfig.json via Settings -> Cascade -> MCP Servers. Add the endpoint details and hit refresh. Cascade auto-discovers the tools immediately.

Q: Can Windsurf pull a Hotmart sales report for a specific date range?

Yes. The agent uses the getsalesreport tool to fetch aggregated data. You just tell it which dates you need analyzed.

Q: Why should I use Windsurf for Hotmart integrations?

Cascade chains actions autonomously. It will run listproducts, find the active ones, and map them to listpayments without needing constant prompts.

Q: Does the server expose my customer emails?

Tools like getsalebyuser do access buyer email addresses and transaction histories. Vinkius runs this connection in an ephemeral, zero-trust V8 Isolate. The sandbox drops all memory the second the request finishes, leaving zero trace of your customer data.

Give Cascade direct access to your Hotmart account. Windsurf builds e-commerce integrations without asking for permission at every step.

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 Windsurf

Create your Vinkius account to connect Hotmart to Windsurf 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 Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Let Windsurf audit your sales history

Cascade pulls raw transaction data using `list_sales_history` and cross-references it with `list_commissions`. You set the reconciliation goal. The agent handles the pagination and data merging automatically. Instead of writing custom scripts to find missing payouts, you just ask for a summary. The IDE fetches the exact records, writes the analysis to a local file, and highlights any discrepancies right in your editor.

Manage affiliates and subscriptions

Your agent tracks recurring revenue by calling `list_subscriptions` to identify churn risks. It then queries `list_affiliates` to see who drove those specific signups. This MCP Server turns a fragmented API into a single data source. Cascade maps a specific user email to their purchase history via `get_sale_by_user` and instantly generates a status report.

Configure webhooks autonomously

Setting up event listeners usually means jumping between documentation and your codebase. Now, the agent calls `list_webhooks` to see what is currently firing in your account. It compares the live configuration against your local endpoint logic. If a product listed in `list_products` is missing a webhook trigger, Cascade spots the gap before you deploy.

Setup guide

Set up Hotmart MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Hotmart MCP

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

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Hotmart payment history." If connected, Cascade will call the Hotmart tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.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 Windsurf

Open your mcp_config.json via Settings -> Cascade -> MCP Servers. Add the endpoint details and hit refresh. Cascade auto-discovers the tools immediately.

Yes. The agent uses the `get_sales_report` tool to fetch aggregated data. You just tell it which dates you need analyzed.

Cascade chains actions autonomously. It will run `list_products`, find the active ones, and map them to `list_payments` without needing constant prompts.

No. The list tools return paginated data naturally. Your agent writes the loop to fetch all pages until the data set is complete.

Tools like `get_sale_by_user` do access buyer email addresses and transaction histories. Vinkius runs this connection in an ephemeral, zero-trust V8 Isolate. The sandbox drops all memory the second the request finishes, leaving zero trace of your customer data.

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