Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use Heap with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Automate product analytics via Heap. track events, identify users, and manage segments directly from any AI agent.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 12 capabilities

The complete Heap capability set.

These are the exact actions your AI can choose when you ask it to work with Heap.

Capability set01 / 03

01-04

4 capabilities in this set.

Part of 12 available through Heap.

  1. 01

    Get API usage

    Check current API usage and project status

  2. 02

    Track event

    Properties should be a JSON string. Track a server-side event for a user in Heap

  3. 03

    Add account properties

    Add or update properties for an account (group of users)

  4. 04

    Bulk add user properties

    Update properties for multiple users in a single request

Capability set02 / 03

05-08

4 capabilities in this set.

Part of 12 available through Heap.

  1. 05

    Get segments

    List all segments defined in your Heap project

  2. 06

    Query user profiles

    Query and filter user profiles based on criteria

  3. 07

    Get event definitions

    List all custom event definitions in Heap

  4. 08

    Add user properties

    Add or update custom properties for a user profile

Capability set03 / 03

09-12

4 capabilities in this set.

Part of 12 available through Heap.

  1. 09

    Bulk track events

    Track multiple events concurrently for high-throughput

  2. 10

    Delete user data

    Permanently delete a user and all their associated data (GDPR)

  3. 11

    Get my profile

    Get information about the authenticated API key

  4. 12

    Identify user

    Associate an anonymous session with a specific user identity

Observed, not estimated

880ms average. Fast in production.

Heap is checked daily against the live service.

Daily averagePeak 1130ms
Aug 20Today
Fastest day
738ms
Slowest day
1130ms
14-day trend
Stable+2%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 12 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Heap, so you can see the experience inside your AI.

It does not authenticate your account with Heap. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Heap Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_Pn4btlTsBht307lZ93t32Og42XTCaaYQZ5x3ubYE/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Heap capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "heap-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_Pn4btlTsBht307lZ93t32Og42XTCaaYQZ5x3ubYE/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions Heap owners ask.

  • 01

    How do I find my Heap App ID and API Key?

    Log in to Heap, go to Account > Projects, and select your project. Your App ID will be visible there. For the API Key, navigate to the API section in your project settings to generate a server-side key.

  • 02

    Can I track events server-side through this integration?

    Yes! Use the track_event capability. You provide the user identity, event name, and optional properties. This is perfect for capturing actions that happen outside the client browser.

  • 03

    How do I update user properties in bulk?

    Use the bulk_add_user_properties capability. You must provide a JSON array containing objects with identity and properties for each user you wish to update.

  • 04

    Is the data deletion capability permanent?

    Yes. The delete_user_data capability triggers a permanent deletion of the user identity and all historical data from Heap, helping you comply with GDPR and CCPA requests.

Explore

More in Data Analytics

Suggestions