How to Use the Heap MCP in Cline

Q: Can Cline clean up test accounts in Heap after running integration tests?

Yes, Cline uses deleteuserdata to wipe mock profiles from Heap once your integration tests finish in VS Code. This keeps your Heap analytics environment clean and prevents compliance violations. Cline automates this cleanup as the final step of your VS Code test suite.

Q: How does Cline handle API rate limits when querying Heap?

Cline monitors your Heap performance using getapiusage before initiating large data transfers. If you run close to your monthly Heap threshold, Cline pauses operations in VS Code to prevent overage charges. This keeps your automated workflows running safely within your Heap plan limits.

Q: How do I verify that my Heap tracking keys are active in Cline?

Run getmyprofile inside Cline to check the current status of your Heap API credentials. The tool returns the project metadata associated with your connection directly to Cline. If the Heap key is invalid, Cline will prompt you to update your environment variables in VS Code.

Build production-ready Heap tracking pipelines and verify user cohorts directly from Cline without leaving your editor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Heap MCP to Cline

Create your Vinkius account to connect Heap to Cline 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 Heap with Cline

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Link Anonymous Sessions inside Cline

`identify_user` connects untracked visitor sessions to registered Heap customer accounts during Cline integration tests in VS Code. Cline runs this tool to verify that your login flows stitch historical Heap data correctly. You do not need to trigger mock requests in your browser to check the registration pipeline when Cline is managing the test.

Validate Active Heap Segments with Cline

`get_segments` pulls your active marketing cohorts from Heap directly into the Cline sidebar. Your Cline agent checks this list to ensure your feature flags target the correct customer groups. You avoid shipping broken conditional logic in VS Code because the tool verifies the Heap segment names first.

Track Events Instantly with this Cline MCP Server

`track_event` sends custom backend signals directly from your active VS Code workspace using this MCP Server. Cline writes the tracking wrapper, invokes the tool to send a test event to Heap, and confirms the ingestion succeeded. You get immediate feedback inside Cline on whether your payload matches the expected Heap schema.

Setup guide

Set up Heap MCP in Cline

Prerequisites

VS Code with Cline extension installed
Active Vinkius subscription with a valid endpoint token

1

Open Cline MCP settings

Click the Cline icon in the VS Code sidebar to open the Cline panel. Then click the MCP Servers icon (server stack) at the top-right corner of the panel.
2

Add a remote server

Click "Remote Servers" at the top, then click "Add Remote MCP". In the Name field, type heap-mcp. In the URL field, paste your Vinkius endpoint: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp. Get your token from cloud.vinkius.com.
3

Enable the server

After saving, the server appears in the Cline MCP panel. Toggle the switch to enable it. The status indicator turns green when the connection is live.
4

Start using tools

Return to the Cline chat and ask: "Check my latest Heap refund status." Cline will discover the available tools and request your approval before invoking each one — giving you full control over every action.

Cline MCP Settings

{
  "mcpServers": {
    "heap-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 Heap. 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 Heap 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 Heap MCP in Cline

Open the Cline sidebar in VS Code and click the MCP Servers icon to access the marketplace. You can add the Heap server with a single click or paste the connection URL into your settings. Cline immediately gains access to your Heap analytics tools.

Yes, Cline uses `delete_user_data` to wipe mock profiles from Heap once your integration tests finish in VS Code. This keeps your Heap analytics environment clean and prevents compliance violations. Cline automates this cleanup as the final step of your VS Code test suite.

Cline monitors your Heap performance using `get_api_usage` before initiating large data transfers. If you run close to your monthly Heap threshold, Cline pauses operations in VS Code to prevent overage charges. This keeps your automated workflows running safely within your Heap plan limits.

Run `get_my_profile` inside Cline to check the current status of your Heap API credentials. The tool returns the project metadata associated with your connection directly to Cline. If the Heap key is invalid, Cline will prompt you to update your environment variables in VS Code.

Your Heap customer event data and account properties flow through an encrypted tunnel directly from Cline to the analytics gateway. Vinkius employs an ephemeral execution model where no tracking payloads are cached or inspected. This secure MCP channel guarantees that sensitive behavioral metrics never touch third-party storage.

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