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.
https://agents.mattering.io/api/internal/v1/
5 MCP 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.
| Resource | Endpoints | Methods |
|---|---|---|
| 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 toolsShape 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.