• REALTIME
  • BATCH
  • HUMAN
  • CLEAN

How to track server side events with your AI

Connect Heap to your AI client to turn natural language into precise data points. Your agent handles the event payloads while you focus on the logic.

Ask AI about this page

Short answer

How can I send server-side events to Heap using my AI?

You tell your AI what happened, and it uses the Heap MCP to fire the event. It maps your description to the right properties and sends the data immediately. You'll see the results in your Heap dashboard through these specific outcomes.

Data outcomes

Where your data lands

What happens after you prompt your agent.

REALTIME

Instant event firing

The AI sends individual interaction data to Heap as soon as you confirm the action. Your analytics reflect the event without manual API calls.

BATCH

Bulk data uploads

Your agent can group multiple user actions into a single request. This keeps your Heap event stream organized and efficient.

HUMAN

Review required

You decide which events are important enough to track. The AI proposes the event structure, but you pull the trigger.

CLEAN

Structured properties

The AI organizes messy descriptions into clean key-value pairs. This makes your Heap segments much easier to build later.

The workflow

What your AI does when <the thing arrives>.

The AI acts as the bridge between your conversation and the Heap API.

  1. Interpret intent

    Your agent reads your description of a user action and identifies the necessary event name and properties.

    track_event

  2. Single event capture

    The AI sends a specific interaction to Heap using the provided event details.

    track_event

  3. Mass event processing

    When you describe a series of actions, the AI bundles them to reduce overhead.

    bulk_track_events

  4. Data validation

    The agent checks that the event payload matches what Heap expects before sending.

    track_eventbulk_track_events

Try it

Copy these to start.

Use these prompts to begin tracking data.

Starting points

Replace the bracketed text with your actual event names and user attributes.

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"
    }
  }
}
Copy into chat04

  • Track a 'Purchase Completed' event in Heap with the user_id '12345' and total_amount '50.00'.

  • Send a bulk update to Heap for these three users: user_id 'A', 'B', and 'C' marking them as 'Premium'.

  • Log a 'Button Clicked' event for the 'Sign Up' button with the property 'location: header'.

  • Record a 'Subscription Cancelled' event for user '9876' and include the reason 'too expensive'.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Heap once, then ask.

Link your Heap account to Vinkius in one click. Your credentials stay encrypted, and you can start sending events immediately through any compatible client.

Connect Heap to your AI

FAQ

How this task behaves

  • 01

    Can the AI create new event definitions in Heap?

    No. The AI can only send data to existing event structures using the available tools.

  • 02

    Does the AI automatically decide which events to track?

    No. You must explicitly tell the AI which event to track or which data to send.

  • 03

    Can I send multiple events at once?

    Yes, you can use the bulk tracking capability to send multiple events in a single operation.

  • 04

    Will the AI delete any existing data in my Heap account?

    No. This MCP only has tools to send and track data, not to delete or modify historical records.

  • 05

    Can the AI change my Heap user properties?

    No. The AI can only send event data and properties as part of a tracking call.

  • More questions about Heap? See everything the Heap Connector can do

Connect Heap to Claude, Cursor, ChatGPT & more