Heap MCP. Track every user event, query profiles, and manage segments via chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Heap MCP Server. Track, manage, and query all user behavior and product events directly from your AI client. Use this server to send custom server-side events, update user profiles, segment cohorts, and comply with GDPR data deletion requests, all through conversation.
What your AI agents can do
Add account properties
Adds or updates properties for a defined group of users (an account).
Add user properties
Adds or updates custom properties to a specific user's profile.
Bulk add user properties
Updates custom properties for multiple user profiles in one request.
Send specific, custom server-side events to Heap, capturing the exact moment a user performs an action.
Add, change, or update custom properties for a single user or a group of users.
Link an anonymous user session (like a browser ID) to a known, specific user identity.
Filter and retrieve user profiles based on criteria like specific attributes or behaviors.
List all defined user segments (cohorts) within your Heap project.
Permanently delete all data associated with a user ID, fulfilling GDPR or CCPA requests.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
Heap MCP Server: 12 Tools for Data Analytics
These tools let you manage the lifecycle of user data—from tracking a single event to deleting all associated records—all through natural conversation.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Heap on Vinkius019d75aeadd account properties
Adds or updates properties for a defined group of users (an account).
019d75aeadd user properties
Adds or updates custom properties to a specific user's profile.
019d75aebulk add user properties
Updates custom properties for multiple user profiles in one request.
019d75aebulk track events
Tracks multiple user events at once, which is fast for high-volume logging.
019d75aedelete user data
Permanently deletes a user and all their associated data, fulfilling GDPR requirements.
019d75aeget api usage
Checks your current Heap API usage and project status.
019d75aeget event definitions
Lists every custom event definition set up in your Heap project.
019d75aeget my profile
Retrieves information about the API key currently being used.
019d75aeget segments
Lists all the user segments (cohorts) defined in your Heap project.
019d75aeidentify user
Links an anonymous session to a known user identity so future events track correctly.
019d75aequery user profiles
Filters and retrieves user profiles based on specific criteria or attributes.
019d75aetrack event
Tracks a single, server-side event for a specific user in Heap.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Heap, then connect any of our 4,800+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,800+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
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.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 12 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Manually tracking user behavior is a pain. You click this tab, copy this ID, and paste it into another sheet.
Today, logging user behavior means jumping between the product dashboard, the database admin panel, and the spreadsheet. You manually identify a session ID, copy the user's current status, and then trigger a separate data update in a different system. The process is slow, error-prone, and you lose context the moment you switch tabs.
With this MCP server, you just tell your agent, 'Track event X for user Y, and update their status to Z.' The agent runs the necessary tools (`track_event` and `add_user_properties`) in sequence, handles the IDs, and confirms the action. It's all in one chat window.
Heap MCP Server: Manage user profiles with the `add_user_properties` tool.
Before, updating a user's profile required navigating to the profile management section, finding the user ID, and manually adding or changing the property key/value pair. For bulk changes, you'd export a CSV, update it in Excel, and then re-import it, praying the format was correct.
Now, you just tell your agent to use `add_user_properties` and list the changes. The agent manages the API calls and ensures the data gets updated correctly. You don't touch a spreadsheet.
What you can do with this MCP connector
You can hook up your Heap.io analytics account to your AI client and manage all your product data and user identities just by talking to your agent. You don't gotta mess around in complex dashboards to track an event or check a segment size; your agent handles it.
Track User Actions: You can send specific, custom server-side events to Heap, capturing the exact moment a user does something. To log a single event for a specific user, use track_event. If you're logging a bunch of events at once, use bulk_track_events. You also gotta know what custom event definitions you've set up; use get_event_definitions to list 'em.
Define or Update User Profiles: You can add or update custom properties for a specific user by calling add_user_properties. If you wanna update a whole group of users, use bulk_add_user_properties to change properties for multiple profiles in one shot. You can also add or update properties for a defined group of users (an account) using add_account_properties.
To see what data's attached to a user, you can run query_user_profiles to filter and get profiles based on specific attributes or behaviors. If you need to know about the API key your agent is using, check get_my_profile.
Connect Anonymous Sessions: When a user is anonymous, you can link that session (like a browser ID) to a known user identity using identify_user, making sure all future events track to the right person.
Manage User Groups: You can list every user segment (cohort) defined in your Heap project by calling get_segments. You can also check your current Heap API usage and project status with get_api_usage.
Comply with Data Deletion: To handle GDPR or CCPA requests, you can permanently delete a user and all their associated data using delete_user_data.
Other Functions: You can also use get_my_profile to get info on the API key, and query_user_profiles to pull user profiles based on criteria. You can check the usage status with get_api_usage.
019d75ae-ffd9-72f2-9085-2974bd0e1b7d 
How Heap MCP Works
- 1 First, you subscribe to the Heap MCP Server and provide your Heap App ID and API Key.
- 2 Then, you ask your AI agent to perform an action—for instance, 'List all active segments' or 'Track event X for user Y'.
- 3 The agent executes the necessary tool call, interacts with the Heap API, and returns the structured data or a confirmation message to you.
The bottom line is that you use natural language to trigger complex data operations that would normally require manual API calls and dashboard navigation.
Who Is Heap MCP For?
Product Managers, Growth Engineers, and Data Privacy Officers. If your job requires knowing why a user dropped off, or if you need to prove you can delete a user's data on demand, this is for you. Stop clicking through dashboards. Start talking to your data.
Checks segment sizes or verifies event definitions during the planning phase. Instead of waiting for a data pull, they ask the agent directly.
Automates the tracking of server-side events and updates user properties in bulk, running complex data logging without writing boilerplate code.
Executes GDPR data deletion requests instantly by calling delete_user_data, ensuring compliance is a conversational, verifiable process.
What Changes When You Connect
- Bulk Operations: Instead of sending 100 individual API calls, use
bulk_track_eventsto send a hundred events in one go. This keeps your logging fast and prevents rate limiting issues. - Identity Resolution: Use
identify_userto link anonymous sessions to specific user IDs. This ensures that all future events are correctly attributed to the right person, eliminating data silos. - Compliance: Need to delete user data for GDPR? Call
delete_user_data. It permanently removes the user and all linked data. This is a single, verifiable chat command. - Deep Querying: Don't just look at basic metrics. Use
query_user_profilesto filter users based on complex criteria, like 'all users who saw page X but never completed checkout'. - Schema Alignment: Use
get_event_definitionsto check your current schema. You can verify if the event name you want to track actually exists before runningtrack_event. - Account Management: Need to update a group of users?
bulk_add_user_propertieshandles updating properties for multiple accounts at once, saving time.
Real-World Use Cases
Debugging a Funnel Leak
The QA team notices a drop-off between 'Add to Cart' and 'Payment'. They ask the agent to query_user_profiles for users who triggered the 'Add to Cart' event but who do not have a 'Payment Initiated' event. The agent runs the query and returns a list of IDs, allowing the team to immediately investigate the missing step.
Handling GDPR Requests
A user contacts support and requests data deletion. Instead of opening a support ticket and manually scrubbing databases, the agent runs delete_user_data with the user's ID. The process is logged, verifiable, and done in seconds.
Batch Updating User Status
The marketing team runs a campaign and needs to tag 5,000 users as 'High Value Lead'. They use bulk_add_user_properties to apply this single property update across the entire group, saving massive manual data entry.
Analyzing Cohort Health
The PM needs to see how many 'Premium' users are currently active. They ask the agent to get_segments first, confirming the segment exists. Then, they ask to query_user_profiles filtered by the 'Premium' segment to get the precise count.
The Tradeoffs
Writing a script for every minor change
The developer writes a dedicated script just to track a simple 'button click' event, even if the schema changes slightly. This script breaks every time the API endpoint changes.
→
Just use the track_event tool. It sends the event definition, and your AI client handles the underlying API calls. If the schema changes, you only update the client's instructions, not the core logging logic.
Mixing up user and account data
Trying to update a user profile using an account ID, or vice versa. This leads to data corruption because the tools treat individual users and groups differently.
→
Use add_user_properties for changes specific to one user. If you need to update a group of users, use add_account_properties or bulk_add_user_properties.
Not checking for existing segments
Assuming a segment like 'Power Users' exists and trying to query it, only to find the segment ID is wrong, and the entire query fails.
→
Always start by calling get_segments. This lists all defined user cohorts. Then, you can confidently ask the agent to query that specific segment.
When It Fits, When It Doesn't
Use this if you need to treat product data like a conversation. If your goal is to ask questions about user behavior ('Who did X and Y?'), or make changes to user data ('Mark this user as high value'), this server works. It turns complex, multi-step data manipulation into a single prompt.
Don't use this if your only goal is to view a static, historical dashboard of data that already exists. For simple visualization, stick to your native analytics platform. If you only need to validate schema names, use get_event_definitions first, then proceed with track_event.
It's essential for data integrity and operational flow. It’s not just a data logger; it’s a data action layer.
Common Questions About Heap MCP
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.
Can I track events server-side through this integration? +
Yes! Use the track_event tool. You provide the user identity, event name, and optional properties. This is perfect for capturing actions that happen outside the client browser.
How do I update user properties in bulk? +
Use the bulk_add_user_properties tool. You must provide a JSON array containing objects with identity and properties for each user you wish to update.
Is the data deletion tool permanent? +
Yes. The delete_user_data tool triggers a permanent deletion of the user identity and all historical data from Heap, helping you comply with GDPR and CCPA requests.
How do I use the `query_user_profiles` tool to filter user data? +
You pass criteria (attributes or behavior) directly to the tool. The system returns a list of matching profiles, allowing you to analyze specific user groups instantly.
Can I use `bulk_track_events` if I'm sending data from multiple sources? +
Yes, bulk_track_events is built for high throughput. You bundle multiple event payloads into a single request, making it efficient for multi-source data ingestion.
What is the difference between `add_user_properties` and `add_account_properties`? +
The difference is scope: add_user_properties updates a single user profile. add_account_properties affects all users within a defined group or account.
Does `delete_user_data` handle data deletion for multiple users? +
The tool deletes data for one user at a time. You must call delete_user_data sequentially for each user ID you want to remove.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.