Menu

Mattering Forms MCP tools

9 tools on the Mattering MCP gateway at https://mcp.mattering.io/mcp. Each call forwards your token to the Forms 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.

Diagnostics

forms_list_capabilities

List the Forms service's registered capabilities (debug helper).

Full description

List the Forms service's registered capabilities (debug helper).

Returns the available capability names, HTTP methods, paths, categories, and required / optional parameter lists. Useful for discovering what the service exposes without paging through the docs.

Takes no parameters.

Forms

forms_create_form

Create a form in a workspace, optionally with its field list.

Full description

Create a form in a workspace, optionally with its field list.

Required: space_id (from forms_list_my_spaces), title.

fields is an ordered list of field specs: ``{"label": "Your email", "field_type": "email", "is_required": true, "placeholder": "", "help_text": "", "options": []}``. Valid field_type values: text, textarea, number, date, dropdown, multi_select, checkbox, website, email, phone (options is required for dropdown / multi_select).

New forms start as drafts: publish with forms_update_form(short_code, status="published").

Parameters

NameTypeRequiredDefault
space_idstrrequirednone
titlestrrequirednone
descriptionOptional[str]optionalnone
fieldsOptional[list]optionalnone

Calls

forms_get_form

Get a single form by its short code, including its ordered field

Full description

Get a single form by its short code, including its ordered field list and cross-app mappings. The public_url is the shareable page.

Parameters

NameTypeRequiredDefault
short_codestrrequirednone

Calls

forms_list_forms

List forms, paginated.

Full description

List forms, paginated.

Optional filters: space_id (workspace), status ("draft", "published", "closed"). limit defaults to 50 (cap 200); page with offset. The response meta carries total / has_more.

Parameters

NameTypeRequiredDefault
space_idOptional[str]optionalnone
statusOptional[str]optionalnone
limitOptional[int]optionalnone
offsetOptional[int]optionalnone

Calls

forms_update_form

Update a form by its short code.

Full description

Update a form by its short code.

All parameters optional; only supplied ones change. status moves the form through its lifecycle: "published" opens the public page for responses, "closed" stops accepting them, "draft" hides it. fields REPLACES the field list (pass each existing field back with its id to keep it; omit a field to delete it). Styling accepts primary_color / background_color (hex), button_label and confirmation_message.

Parameters

NameTypeRequiredDefault
short_codestrrequirednone
titleOptional[str]optionalnone
descriptionOptional[str]optionalnone
statusOptional[str]optionalnone
fieldsOptional[list]optionalnone
primary_colorOptional[str]optionalnone
background_colorOptional[str]optionalnone
button_labelOptional[str]optionalnone
confirmation_messageOptional[str]optionalnone

Calls

Forms workspaces

forms_create_workspace

Create a workspace in the caller's organization.

Full description

Create a workspace in the caller's organization.

Required: name. Optional: description, color (hex, e.g. #00BFFF). The workspace is created canonically in the Mattering platform, so it appears across apps.

Parameters

NameTypeRequiredDefault
namestrrequirednone
descriptionOptional[str]optionalnone
colorOptional[str]optionalnone

Calls

forms_list_workspaces

List workspaces. Optional ``space_id`` narrows to one workspace.

Parameters

NameTypeRequiredDefault
space_idOptional[str]optionalnone

Calls

Spaces

forms_list_my_spaces

List Forms spaces (workspaces) accessible to the current user.

Full description

List Forms spaces (workspaces) accessible to the current user.

Empty results are annotated with the resolved identity so an empty list can be told apart from an identity mismatch.

Takes no parameters.

Calls

Submissions

forms_list_form_submissions

List a form's submissions, newest first, paginated.

Full description

List a form's submissions, newest first, paginated.

Each submission carries its answers snapshot (keyed by field id, with label/type/value) and mapping_results: the outcome of each configured cross-app mapping (Productivity task / Sales contact / Sales business), including the created record id.

Parameters

NameTypeRequiredDefault
short_codestrrequirednone
limitOptional[int]optionalnone
offsetOptional[int]optionalnone

Calls

Identity tools (every app)

The gateway registers these once, outside any app family. Call whoami first when a result looks empty.

auth_statusReport token health, expiry, bound principal, and catalog version.
get_accountReturn the current user's account profile (email, name, id).
get_organizationReturn the organization this session is currently acting as.
list_organizationsList every organization the authenticated identity belongs to.
reauthenticateExplain how to refresh this connection's authentication.
switch_accountExplain how to re-authenticate as a different account / org.
whoamiShow who this MCP session is authenticated as.
Start Free Explore our Products