Menu

Mattering Comms API

Channels, messages and search for Mattering Comms, plus the service-only call control surface agents use.

User APIhttps://comms.mattering.io/api/user/v1/ Service tierhttps://comms.mattering.io/api/internal/v1/ 6 MCP tools

Resources

22 endpoints, 8 on the User API, 14 service-only.

ResourceEndpointsMethodsTiers
Channels 9 GETPOSTDELETE User API
Messages 2 GETPOST User API
Search 1 GET User API

Service tier only

These resources are reachable with the internal secret only. They are documented for operators and for anyone reading the MCP tools that wrap them.

ResourceEndpointsMethods
Calls 5 POST
Org erasure 1 GET
Org export 1 GET
Unread summary 1 GET
User erasure 1 GET
User export 1 GET

MCP tools

The Mattering MCP gateway exposes 6 tools for Comms. Each wraps one of the endpoints above on the User API, forwarding your token.

See the Comms MCP tools

Shape against the shared standard

Mattering is converging every app on one API shape (the Base API Template). This is where Comms stands, measured from its code. Read it before assuming the envelope on one app matches another.

Yes User tier mounted (/api/user/v1/)
Yes Internal tier versioned (/api/internal/v1/)
Not yet One api_urls.py included on both tiers
Yes Responses use the {data, meta} envelope 22 of 22 endpoints
Not yet Collection reads paginate with meta.total 2 of 8 list endpoints paginate; hard caps on 8
Yes Errors carry a snake_case code and a detail 74 of 74 error returns use a stable code

Unpaginated reads with a hard cap (results beyond the cap are not returned and no total is reported): calls/{channel_public_id}/guest-link/ (32), calls/{channel_public_id}/presence/ (32), calls/{channel_public_id}/recording/ (32), calls/{channel_public_id}/screen-share/ (8), channels/create/ (120), channels/resolve/ (500), channels/{channel_public_id}/delete/ (32), channels/{channel_public_id}/members/ (32).

Source: CommsCore/api_urls.py, MatteringComms/urls.py. Regenerated by tools/build_api_docs.py.

Start Free Explore our Products