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
Name
Type
Required
Default
channel_public_id
str
required
none
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
Name
Type
Required
Default
channel_public_id
str
required
none
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.
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).
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.
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.
We use strictly necessary cookies to run this site. With your permission we also use analytics cookies
(Google Analytics and our own visit tracking) to see which pages work. Read the
Cookie notice.