create_comment
Create Comment
Creates a comment on an existing thread. Content can be plain text or rich text (HTML). When rich text is provided, plain text is ignored.
Ask your agent in plain language. Each of these maps to a real tool on the server.
create_comment
Creates a comment on an existing thread. Content can be plain text or rich text (HTML). When rich text is provided, plain text is ignored.
create_event
DEPRECATED — use `schedule_event` instead. Creates a new event in your Heartbeat community. Events can have a location (Zoom requires an integrated Zoom account, Heartbeat creates a custom voice channel). You can invite attendees by email — existing users are invited directly, others receive an email invite.
create_channel
DEPRECATED — use `create_community_channel` instead. Creates a new channel in your Heartbeat community. Channels can be of type thread, chat, or voice.
manage_group
Creates a new group or manages group membership in your Heartbeat community. Can create groups, add users to groups, or remove users from groups. When adding a user, you can optionally remove them from sibling groups (groups sharing a parent), useful for moving users between stages.
send_invitation
Sends an invitation email to a new user to join your Heartbeat community. Optionally specify a pre-approved invitation link to automatically approve the user.
deactivate_member
Deactivates a user in your Heartbeat community. The user will no longer be able to access the community, but their threads, comments, and messages are preserved. Can also reactivate a previously deactivated user.
create_thread
Creates a new thread in a specific channel. Content can be plain text or rich text (HTML). When rich text is provided, plain text is ignored. Supported HTML tags: p, a, b, h1, h2, h3, ul, li, br.
update_member
DEPRECATED — use `edit_member_profile` instead. Updates an existing user's information in your Heartbeat community. Can update name, email, roles, groups, bio, social links, and other profile fields.
send_direct_message
Sends a direct message to a community member. Useful for automated notifications, bot responses, or personalized outreach.
find_user
Finds a user in your Heartbeat community by email address or retrieves a specific user by ID.
create_member
DEPRECATED — use `provision_member` instead. Creates a new user in your Heartbeat community. Optionally assign groups, set a profile picture, bio, social links, and trigger an introduction thread.
get_recent_posts
DEPRECATED — use `list_channel_threads` instead. Retrieves the most recently created threads in your Heartbeat community. Can filter by channel. "Recent" refers to creation timestamp — only the most recently created posts are returned.
list_members
Lists members of your Heartbeat community with optional filtering by group, role, or creation date. Returns a paginated list of users.
list_channels
Lists channels in your Heartbeat community with optional filtering by type or archived status.
list_groups
Lists access groups in your Heartbeat community with optional filtering. Can filter by parent group or by user membership.
list_events
List community events, optionally filtered by an access group from list_access_groups. Returns provider event IDs, times, invited members and groups, and metadata.
create_community_channel
Create a thread, chat, or voice channel using a category ID from list_channel_categories. Returns the actual HTTP status and provider response.
list_channel_categories
Discover the channel category IDs and names needed to create community channels.
create_invitation_link
Create an invitation link for a role and groups, returning the real invitation code and provider metadata. This operation creates a link and does not send an invitation email.
get_thread
Read one thread, including its comments, reactions, provider permalink, and file URL metadata.
list_channel_threads
Read threads from one channel, newest by creation time first. Discover channel IDs with list_community_channels. Responses retain provider permalinks, file URLs, comments, and other metadata.
list_roles
Discover the community role IDs and names needed to provision members or create invitation links.
get_event
Retrieve one community event by an ID from list_events, preserving provider metadata.
list_community_channels
List all community channels with provider channel types and draft state. This endpoint is not paginated.
schedule_event
Create an event with the start time, duration, location, and optional invited emails or group IDs. Returns the actual HTTP status and provider response.
edit_member_profile
Update a member profile using their existing email address. This operation does not change the member email, role, or groups. Use manage_group_memberships for group membership changes.
manage_group_memberships
Add members to, or remove members from, an access group using email addresses. Discover the group ID with list_access_groups. Adding members can remove them from sibling groups.
list_invitations
List community invitation links with their actual codes, roles, and groups. Invitation codes do not identify an API key or the current user.
provision_member
Create a community member with a full name and a role. Discover role IDs with list_roles and group IDs with list_access_groups. Returns the actual HTTP status and provider response without assuming a profile was returned.
post_thread
Create a thread using formatted text in a channel from list_community_channels. Returns the actual thread with its provider permalink, file URLs, and metadata.
change_member_access
Deactivate or reactivate a member by email. Deactivation removes community access while preserving threads, comments, and messages.
list_community_members
List all members returned by the Heartbeat community API, including role names and group memberships. This endpoint is not paginated.
find_members
Find community members by email, or retrieve one member by user ID. Returns the complete documented profile and additional provider metadata.
create_access_group
Create an access group, optionally assigning member emails and a parent group. Discover existing group IDs with list_access_groups. Returns the actual HTTP status and provider response.
list_access_groups
List all community access groups, their parent IDs, archived state, and member information. This endpoint is not paginated.
post_comment
Create a thread comment or a reply to a top-level comment using formatted text. Heartbeat supports two comment levels. Returns the actual comment and provider metadata.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Manage an online community on Heartbeat. Create, retrieve, update, and deactivate members. Manage groups and group membership, including moving users between groups. Create threads and comments in channels with plain text or rich text (HTML) content. Create channels and events, with support for Zoom or built-in voice locations. Send direct messages to community members. Send invitation emails to new users. Configure webhooks to receive notifications for community activity such as new users, threads, events, group joins, course completions, event RSVPs, direct messages, and abandoned invitations.
Common questions about connecting Heartbeat to AI agents with Metorial.