Menu

Mattering Comms MCP tools

6 tools on the Mattering MCP gateway at https://mcp.mattering.io/mcp. Each call forwards your token to the Comms User API, so a tool can do exactly what your key can do.

Connect any MCP client to https://mcp.mattering.io/mcp; it discovers the Mattering sign-in and asks you to approve the tools it may use. Tool names, parameters and descriptions below are read from the gateway source. See the MCP gateway concept page for connection details.

Channels

comms_delete_channel

Delete a channel the caller OWNS, or any channel in a workspace the

Full description

Delete a channel the caller OWNS, or any channel in a workspace the caller administers. IRREVERSIBLE: messages, memberships, pins, call records and transcripts go with it (attachment files stay in the platform library). Required: channel_public_id. Direct messages and #general cannot be deleted (not_a_channel / general_protected); a channel the caller may see but not manage returns owner_required.

Parameters

NameTypeRequiredDefault
channel_public_idstrrequirednone

Calls

  • DELETE/api/user/v1/channels/{channel_public_id}

comms_get_channel

Get a single channel the caller can access, by its public_id.

Full description

Get a single channel the caller can access, by its public_id.

Required: channel_public_id. A channel in another org, or a private channel the caller isn't a member of, returns a not-found error (no cross-org existence oracle).

Parameters

NameTypeRequiredDefault
channel_public_idstrrequirednone

Calls

  • GET/api/user/v1/channels/{channel_public_id}

comms_list_channels

List the channels visible to the current user in their active org.

Full description

List the channels visible to the current user in their active org.

Returns public standard channels plus every channel the user belongs to (private channels and DMs). Optional: limit (max rows, default 50, capped at 200) and offset (pagination). Org-scoped server-side.

Parameters

NameTypeRequiredDefault
limitOptional[int]optionalnone
offsetOptional[int]optionalnone

Calls

Messages

comms_list_messages

List root (non-reply) messages in a channel, oldest-to-newest.

Full description

List root (non-reply) messages in a channel, oldest-to-newest.

Required: channel_public_id. Optional: limit (default 50, max 200) and after_seq: pass the previous page's meta.next_cursor to page forward through history; omit it to get the most-recent window. Deleted messages are excluded. The channel is resolved fail-closed on the comms side (not-found if the caller can't see it).

Parameters

NameTypeRequiredDefault
channel_public_idstrrequirednone
limitOptional[int]optionalnone
after_seqOptional[int]optionalnone

Calls

  • GET/api/user/v1/channels/{channel_public_id}/messages

comms_post_message

Post a message to a channel the caller is a MEMBER of.

Full description

Post a message to a channel the caller is a MEMBER of.

Required: channel_public_id, body (non-empty). Optional: thread_root_public_id (reply into a thread: must be a root message in the same channel), mention_user_ids (list of org-member user ids to @mention), mention_channel / mention_here (bools).

Posting requires membership: a public channel is readable but not postable until the caller has joined it (returns not_a_member on a 403 otherwise). Returns the created message with its allocated seq.

Parameters

NameTypeRequiredDefault
channel_public_idstrrequirednone
bodystrrequirednone
thread_root_public_idOptional[str]optionalnone
mention_user_idsOptional[List[int]]optionalnone
mention_channelOptional[bool]optionalnone
mention_hereOptional[bool]optionalnone

Calls

comms_search_messages

Search message bodies across the caller's visible channels (their org).

Full description

Search message bodies across the caller's visible channels (their org).

Required: q (case-insensitive substring). Optional: limit (default 50, max 200) and offset. Only channels the caller can see are searched: a channel id from another org yields nothing.

Parameters

NameTypeRequiredDefault
qstrrequirednone
limitOptional[int]optionalnone
offsetOptional[int]optionalnone

Calls

Identity tools (every app)

The gateway registers these once, outside any app family. Call whoami first when a result looks empty.

auth_statusReport token health, expiry, bound principal, and catalog version.
get_accountReturn the current user's account profile (email, name, id).
get_organizationReturn the organization this session is currently acting as.
list_organizationsList every organization the authenticated identity belongs to.
reauthenticateExplain how to refresh this connection's authentication.
switch_accountExplain how to re-authenticate as a different account / org.
whoamiShow who this MCP session is authenticated as.
Start Free Explore our Products