# Heartbeat — MCP server on mcp.ai
> Connect your Heartbeat account and use 7 tools for team collaboration straight from your AI agent. Connect with your own API key. Plug-and-play online communities. Heartbeat provides tools for creating and managing online communities with features for users, channels, events, messages, and more.

By: mcp.ai · official
Page: https://mcp.ai/heartbeat

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_heartbeat?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/heartbeat/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/heartbeat/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/heartbeat/skill.md
Postman collection (v2.1): https://mcp.ai/heartbeat/postman.json

## Tools
- heartbeat_get_events() — Tool to retrieve event information from the community. Use when you need to list events with optional pagination support.
- heartbeat_list_channels(limit?: integer, archived?: string, channelType?: string, startingAfter?: string) — Tool to retrieve a paginated list of channels in the community. Use when you need to list, browse, or search for channels in the Heartbeat community. Supports filtering by archived status, channel typ
- heartbeat_list_groups(limit?: integer, userId?: string, parentGroupId?: string, startingAfter?: string) — Tool to retrieve a paginated list of access groups in the community. Use when you need to browse groups with optional filters for parent groups or user membership. Supports cursor-based pagination.
- heartbeat_list_users(role?: string, limit?: integer, groupId?: string, createdAfter?: string, createdBefore?: string, startingAfter?: string) — Tool to retrieve a paginated list of users in the Heartbeat community. Use when you need to get user information with optional filtering by creation date, group membership, or role.
- heartbeat_reactivate_user(email: string) — Tool to reactivate a previously deleted user by email to allow them to access the community again. Use when you need to restore access for a user who was previously removed.
- heartbeat_retrieve_group(group_id: string) — Tool to retrieve a single group by its ID. Use when you need to get detailed information about a specific group in the Heartbeat community.
- heartbeat_retrieve_user(user_id: string) — Tool to retrieve a single user by their ID. Use when you need to get detailed information about a specific user in the Heartbeat community.

## Example prompts
- "What can I do in Heartbeat?"
- "Show me a summary of my Heartbeat account"

## Links
Docs: https://mcp.ai/docs/mcps/heartbeat
Website: https://mcp.ai/mcps/heartbeat