Mattering Forms API
Forms, fields, submissions and cross-app mappings for Mattering Forms.
https://forms.mattering.io/api/user/v1/
Service tierhttps://forms.mattering.io/api/internal/
9 MCP tools
Resources
14 endpoints, 13 on the User API, 1 service-only.
| Resource | Endpoints | Methods | Tiers |
|---|---|---|---|
| Forms | 2 | GETPOST | User API |
| Mappings | 3 | GETPOSTDELETE | User API |
| Org erasure | 1 | POST | User API |
| Org export | 1 | POST | User API |
| Search | 1 | GET | User API |
| Spaces | 1 | GET | User API |
| Submissions | 1 | GET | User API |
| User erasure | 1 | POST | User API |
| User export | 1 | POST | User API |
| Workspaces | 1 | GETPOST | 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.
| Resource | Endpoints | Methods |
|---|---|---|
| Custom fields | 1 | GET |
MCP tools
The Mattering MCP gateway exposes 9 tools for Forms. Each wraps one of the endpoints above on the User API, forwarding your token.
See the Forms MCP toolsShape against the shared standard
Mattering is converging every app on one API shape (the Base API Template). This is where Forms stands, measured from its code. Read it before assuming the envelope on one app matches another.
| Yes | User tier mounted (/api/user/v1/) | |
| Not yet | Internal tier versioned (/api/internal/v1/) | |
| Not yet | One api_urls.py included on both tiers | |
| Not yet | Responses use the {data, meta} envelope | 0 of 14 endpoints |
| Not yet | Collection reads paginate with meta.total | 2 of 6 list endpoints paginate |
| Not yet | Errors carry a snake_case code and a detail | 31 of 32 error returns use a stable code |
Source: FormsCore/api_urls.py, MatteringForms/urls.py. Regenerated by tools/build_api_docs.py.