Heap MCP Server
for AI Agents
Connect your AI agent to StackOne's Heap MCP server and give it ready-to-use MCP tools out of the box. Auth, tool execution, and security all managed.
Coverage
6 Agent Actions
Create, read, update, and delete across Heap — and extend your agent's capabilities with custom actions.
Authentication
Agent Tool Authentication
Per-user OAuth in one call. Your Heap MCP server gets session-scoped tokens with zero credentials stored on your infra.
Agent Auth →Security
Agent Protection
Every Heap tool response scanned for prompt injection in milliseconds — 88.7% accuracy, all running on CPU.
Prompt Injection Defense →Performance
Max Agent Context. Min Cost.
Free up to 96% of your agent's context window to enhance reasoning and reduce cost, on every Heap call.
Tools Discovery →What is the Heap MCP Server?
A Heap MCP server lets AI agents read and write Heap data through the Model Context Protocol — Anthropic's open standard for connecting LLMs to external tools. StackOne's Heap MCP server ships with pre-built actions, fully extensible via the Connector Builder — plus managed authentication, prompt injection defense, observability, and agent execution runtime. Connect it from MCP clients like Claude Desktop, Claude Code, Cursor, Goose, and VS Code, or from agent frameworks like OpenAI Agents SDK, LangChain, and Vercel AI SDK.
All Heap MCP Tools
Every action from Heap's API, ready for your agent. Create, read, update, and delete — scoped to exactly what you need.
Account Properties
- Add Account Properties
Set custom properties on a Heap account
Track Events
- Track Event
Send a single custom event to Heap
Bulk Track Events
- Bulk Track Events
Send up to 1000 custom events to Heap in a single request
Identify Users
- Identify User
Associate a Heap user_id with a known identity
User Properties
- Add User Properties
Set custom properties on a Heap user
Bulk Add User Properties
- Bulk Add User Properties
Set custom properties on multiple Heap users in a single request
Set Up Your Heap MCP Server in Minutes
One endpoint. Any framework. Your agent is talking to Heap in under 10 lines of code.
Agent Frameworks
{
"mcpServers": {
"stackone": {
"command": "npx",
"args": [
"-y",
"mcp-remote@latest",
"https://api.stackone.com/mcp?x-account-id=<account_id>",
"--header",
"Authorization: Basic <YOUR_BASE64_TOKEN>"
]
}
}
}Check More Data & Analytics MCP Servers
189+ actions
122+ actions
104+ actions
102+ actions
101+ actions
80+ actions
73+ actions
Heap Resources
How to Build an AI Marketing Analytics Agent with Claude + an MCP Gateway
Connect Claude to GA4 and HubSpot through StackOne's MCP gateway. Surface bot traffic, funnel gaps, and signup attribution your dashboard doesn't show.
8 min read
MCP Code Mode: Keeping Tool Responses Out of Agent Context
Anthropic's code_execution processes data already in context. Custom MCP code mode keeps raw tool responses in a sandbox. 14K tokens vs 500.
11 min
Comparing BM25, TF-IDF, and Hybrid Search for MCP Tool Discovery
Benchmarking BM25, TF-IDF, and hybrid search for MCP tool discovery across 916 tools. The 80/20 TF-IDF/BM25 hybrid hits 21% Top-1 accuracy in under 1ms.
10 min
Indirect Prompt Injection Defense for MCP Tools: A Technical Guide
MCP tools that read emails, CRM records, and tickets are indirect prompt injection vectors. Here's how we built a two-tier defense that scans tool results in ~11ms.
12 min
MCP vs A2A: Architecture, Security, and When to Use Each
MCP vs A2A: what each protocol standardizes, how they differ, their shared security risks including indirect prompt injection, and when to use one, both, or a hybrid architecture.
12 min
MCP vs API: What 200+ Connector Builds Taught Us
MCP wraps APIs, it doesn't replace them. After building 200+ connectors that serve both, here's when each approach wins.
14 min read
Heap MCP Server FAQ
Does StackOne have a Heap MCP server?
Heap MCP server vs direct API integration — what's the difference?
How does Heap authentication work for AI agents?
origin_owner_id.Are Heap MCP tools vulnerable to prompt injection?
What is the context bloat of a Heap agent and how do I avoid it?
Can I limit which actions my Heap agent can access?
Can I create custom agent actions for my Heap MCP server?
When should I NOT use a Heap MCP server?
What AI frameworks and AI clients does the StackOne Heap MCP server support?
Put your AI agents to work
All the tools you need to build and scale AI agent integrations, with best-in-class connectivity, execution, and security.