Menu

Mattering Agents API

Agents, grants, knowledge sources, schedules, triggers, runs and the voice and browser runtime surface. Service tier only until the user tier is mounted.

Service tierhttps://agents.mattering.io/api/internal/v1/ 5 MCP tools
No /api/user/v1/ mount exists yet. The MCP gateway reaches these routes with the internal secret and injects the caller's identity headers, so the tool surface is what external callers get today.
Mattering Agents has no User API mount yet. Everything below is on the service tier and is reachable by external callers only through the MCP gateway tools.

Resources

36 endpoints, 36 service-only.

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
Agents 6 GETPOSTDELETE
Browser 6 GETPOST
Inbox 1 GETPOST
Knowledge 2 POST
Org erasure 1 POST
Org export 1 POST
Runs 1 GET
Schedules 3 GET
Search 1 GET
Triggers 2 GETPOST
User erasure 1 POST
User export 1 POST
Voice 10 GETPOST

MCP tools

The Mattering MCP gateway exposes 5 tools for Agents. Each wraps one of the endpoints above on the service tier, carrying your identity in headers.

See the Agents MCP tools

Shape against the shared standard

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

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

Unpaginated reads with a hard cap (results beyond the cap are not returned and no total is reported): agents/{public_id}/ (300), agents/{public_id}/call-invite/ (200), agents/{public_id}/call-review/ (300), agents/{public_id}/call-transcript/ (4), agents/{public_id}/knowledge/ (200), agents/{public_id}/triggers/ (120), agents/{public_id}/voice-turn/ (300), browser-runtimes/heartbeat/ (80), voice-runtimes/heartbeat/ (80).

Source: MatterCore/api_urls.py. Regenerated by tools/build_api_docs.py.

Start Free Explore our Products