Servers Playground How we check Add a server Log in

SubmitraX

Working · 1.1 s

com.submitrax/mcpv1.0.0 Domain verified

Form backend for static sites: create forms, manage submissions, webhooks and exports.

Data & Databases

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.submitrax.com/mcp

Authorization (required)

Bearer token from SubmitraX → Settings → API access (format: Bearer <token>)

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

accept_invite

Accept a pending workspace invitation using its invitation token, linking it to the authenticated user.

tokenstring, required

Invitation token from the invite email link

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

SubmitraX MCP server | mcptry

SubmitraX

Working · 1.1 s

com.submitrax/mcpv1.0.0 Domain verified

Form backend for static sites: create forms, manage submissions, webhooks and exports.

Data & Databases

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.submitrax.com/mcp

Authorization (required)

Bearer token from SubmitraX → Settings → API access (format: Bearer <token>)

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

accept_invite

Accept a pending workspace invitation using its invitation token, linking it to the authenticated user.

tokenstring, required

Invitation token from the invite email link

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (57)

accept_invite

Accept a pending workspace invitation using its invitation token, linking it to the authenticated user.

Argument	Type	Description
token*	string	Invitation token from the invite email link

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "token"
  ],
  "properties": {
    "token": {
      "type": "string",
      "description": "Invitation token from the invite email link"
    }
  }
}

add_form_webhook

Add a notification webhook URL to a form.

Argument	Type	Description
id*	string	Form ID or form key
url*	string	Webhook URL (Slack, Discord, or generic HTTP endpoint)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id",
    "url"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Form ID or form key"
    },
    "url": {
      "type": "string",
      "description": "Webhook URL (Slack, Discord, or generic HTTP endpoint)"
    }
  }
}

bulk_archive_submissions

Archive several submissions at once.

Argument	Type	Description
submissionIds*	array	IDs of the submissions to process

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "submissionIds"
  ],
  "properties": {
    "submissionIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "IDs of the submissions to process"
    }
  }
}

bulk_delete_submissions

Permanently delete several submissions at once.

destructive

Argument	Type	Description
submissionIds*	array	IDs of the submissions to process

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "submissionIds"
  ],
  "properties": {
    "submissionIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "IDs of the submissions to process"
    }
  }
}

bulk_delete_users_admin

Delete multiple user accounts at once. Requires super-admin.

destructive

Argument	Type	Description
userIds*	array	IDs of the users to delete

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "userIds"
  ],
  "properties": {
    "userIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "IDs of the users to delete"
    }
  }
}

create_checkout_session

Start a Stripe subscription checkout for a plan ('free', 'essentials', 'pro'). Downgrades immediately if planType is 'free'.

Argument	Type	Description
planType*	string	Plan to subscribe to
billingPeriod	string	Billing period for paid plans

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "planType"
  ],
  "properties": {
    "planType": {
      "enum": [
        "free",
        "essentials",
        "pro"
      ],
      "type": "string",
      "description": "Plan to subscribe to"
    },
    "billingPeriod": {
      "enum": [
        "monthly",
        "annual"
      ],
      "type": "string",
      "description": "Billing period for paid plans"
    }
  }
}

create_export

Create a CSV or JSON export of a form's submissions, optionally filtered by date range (YYYY-MM-DD).

Argument	Type	Description
formId*	string	Form ID
format	string	Export file format
end_date	string	Only include submissions up to this date (YYYY-MM-DD)
start_date	string	Only include submissions from this date (YYYY-MM-DD)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "formId"
  ],
  "properties": {
    "formId": {
      "type": "string",
      "description": "Form ID"
    },
    "format": {
      "enum": [
        "csv",
        "json"
      ],
      "type": "string",
      "description": "Export file format"
    },
    "end_date": {
      "type": "string",
      "description": "Only include submissions up to this date (YYYY-MM-DD)"
    },
    "start_date": {
      "type": "string",
      "description": "Only include submissions from this date (YYYY-MM-DD)"
    }
  }
}

create_form

Create a new form in a workspace.

Argument	Type	Description
name*	string	Name of the form
email_to	string	Notification email recipient. Defaults to the authenticated user's email
custom_html	string	Custom HTML for the public form page; {{form_url}} is replaced with the submission endpoint
workspace_id*	string	ID of the workspace to create the form in

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name",
    "workspace_id"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the form"
    },
    "email_to": {
      "type": "string",
      "description": "Notification email recipient. Defaults to the authenticated user's email"
    },
    "custom_html": {
      "type": "string",
      "description": "Custom HTML for the public form page; {{form_url}} is replaced with the submission endpoint"
    },
    "workspace_id": {
      "type": "string",
      "description": "ID of the workspace to create the form in"
    }
  }
}

create_template_admin

Create a new template. Requires super-admin.

Argument	Type	Description
name*	string	Template name
slug	string	URL-friendly identifier for the template
type*	string	Template type
content*	string	Template HTML content
is_default	boolean	Whether the template is offered to all users by default
description	string	Short description of the template

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name",
    "type",
    "content"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Template name"
    },
    "slug": {
      "type": "string",
      "description": "URL-friendly identifier for the template"
    },
    "type": {
      "enum": [
        "form",
        "email"
      ],
      "type": "string",
      "description": "Template type"
    },
    "content": {
      "type": "string",
      "description": "Template HTML content"
    },
    "is_default": {
      "type": "boolean",
      "description": "Whether the template is offered to all users by default"
    },
    "description": {
      "type": "string",
      "description": "Short description of the template"
    }
  }
}

create_workspace

Create a new workspace owned by the authenticated user.

Argument	Type	Description
name*	string	Name of the workspace

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the workspace"
    }
  }
}

delete_all_form_submissions

Delete every submission belonging to a form.

destructive

Argument	Type	Description
formId*	string	Form ID

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "formId"
  ],
  "properties": {
    "formId": {
      "type": "string",
      "description": "Form ID"
    }
  }
}

delete_form

Delete a form.

destructive

Argument	Type	Description
id*	string	Form ID or form key

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Form ID or form key"
    }
  }
}

delete_form_webhook

Remove a notification webhook URL from a form.

destructive

Argument	Type	Description
id*	string	Form ID or form key
url*	string	Webhook URL (Slack, Discord, or generic HTTP endpoint)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id",
    "url"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Form ID or form key"
    },
    "url": {
      "type": "string",
      "description": "Webhook URL (Slack, Discord, or generic HTTP endpoint)"
    }
  }
}

delete_submission

Permanently delete a single submission.

destructive

Argument	Type	Description
id*	string	Submission ID

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Submission ID"
    }
  }
}

delete_template_admin

Delete a template. Requires super-admin.

destructive

Argument	Type	Description
id*	string	Template ID

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Template ID"
    }
  }
}

delete_user_admin

Delete a single user account. Requires super-admin.

destructive

Argument	Type	Description
id*	string	User ID

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "User ID"
    }
  }
}

delete_workspace

Delete a workspace along with all its forms and submissions. Only the owner may do this.

destructive

Argument	Type	Description
id*	string	Workspace ID

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Workspace ID"
    }
  }
}

download_export

Download the contents of a previously created export file (CSV or JSON text).

read-only

Argument	Type	Description
filename*	string	The export filename, as returned by create_export or list_form_exports

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "filename"
  ],
  "properties": {
    "filename": {
      "type": "string",
      "description": "The export filename, as returned by create_export or list_form_exports"
    }
  }
}

generate_ai_content

Proxy a request to the configured n8n AI generation webhook (e.g. for AI-assisted form/HTML generation). Requires the server to have AI generation configured.

Argument	Type	Description
payload*	object	Arbitrary JSON payload forwarded to the AI generation webhook

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "payload"
  ],
  "properties": {
    "payload": {
      "type": "object",
      "description": "Arbitrary JSON payload forwarded to the AI generation webhook",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    }
  }
}

generate_workspace_api_token

Generate (or reset) a long-lived API token (sk_...) scoped to a single workspace, for use with public API integrations.

Argument	Type	Description
id*	string	Workspace ID

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Workspace ID"
    }
  }
}

get_auth_status

Check whether an auth token is currently configured for this session.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_current_user

Get the profile of the currently authenticated user.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_form

Get a single form by id or form key.

read-only

Argument	Type	Description
id*	string	Form ID or form key

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Form ID or form key"
    }
  }
}

get_public_form_html

Fetch the rendered public HTML (custom or default template) for a form by its form key. No authentication required.

read-only

Argument	Type	Description
formKey*	string	Public form key, as used in the /f/:formKey URL

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "formKey"
  ],
  "properties": {
    "formKey": {
      "type": "string",
      "description": "Public form key, as used in the /f/:formKey URL"
    }
  }
}

get_workspace

Get a single workspace's details and settings.

read-only

Argument	Type	Description
id*	string	Workspace ID

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Workspace ID"
    }
  }
}

health_check

Check whether the SubmitraX API is reachable and running.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

invite_workspace_member

Invite a new member to a workspace by email. Requires admin access to the workspace.

Argument	Type	Description
yourName*	string	Name of the inviter, shown in the invitation email
theirName*	string	Name of the person being invited
theirEmail*	string	Email address to send the invitation to
workspaceId*	string	Workspace ID

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "workspaceId",
    "theirName",
    "theirEmail",
    "yourName"
  ],
  "properties": {
    "yourName": {
      "type": "string",
      "description": "Name of the inviter, shown in the invitation email"
    },
    "theirName": {
      "type": "string",
      "description": "Name of the person being invited"
    },
    "theirEmail": {
      "type": "string",
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "Email address to send the invitation to"
    },
    "workspaceId": {
      "type": "string",
      "description": "Workspace ID"
    }
  }
}

list_admin_users

Paginated list of all users with plan stats. Requires super-admin.

read-only

Argument	Type	Description
page	number	Page number, starting at 1
limit	number	Number of users per page

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "page": {
      "type": "number",
      "description": "Page number, starting at 1"
    },
    "limit": {
      "type": "number",
      "description": "Number of users per page"
    }
  }
}

list_all_templates_admin

Paginated list of every template. Requires super-admin.

read-only

Argument	Type	Description
page	number	Page number, starting at 1
type	string	Only return templates of this type
limit	number	Number of templates per page

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "page": {
      "type": "number",
      "description": "Page number, starting at 1"
    },
    "type": {
      "enum": [
        "form",
        "email"
      ],
      "type": "string",
      "description": "Only return templates of this type"
    },
    "limit": {
      "type": "number",
      "description": "Number of templates per page"
    }
  }
}

list_form_exports

List the export files previously created for a form.

read-only

Argument	Type	Description
formId*	string	Form ID

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "formId"
  ],
  "properties": {
    "formId": {
      "type": "string",
      "description": "Form ID"
    }
  }
}

list_form_submissions

List all submissions for a specific form.

read-only

Argument	Type	Description
formId*	string	Form ID

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "formId"
  ],
  "properties": {
    "formId": {
      "type": "string",
      "description": "Form ID"
    }
  }
}

list_form_webhooks

List the notification webhook URLs (Slack, Discord, generic) configured on a form.

read-only

Argument	Type	Description
id*	string	Form ID or form key

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Form ID or form key"
    }
  }
}

list_forms

List forms across the user's workspaces, or within one workspace if workspace_id is given.

read-only

Argument	Type	Description
workspace_id	string	Only include this workspace

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "workspace_id": {
      "type": "string",
      "description": "Only include this workspace"
    }
  }
}

list_submissions

List submissions across the user's workspaces, or within one workspace if workspace_id is given.

read-only

Argument	Type	Description
workspace_id	string	Only include this workspace

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "workspace_id": {
      "type": "string",
      "description": "Only include this workspace"
    }
  }
}

list_templates

List default templates available to all users, optionally filtered by type ('form' or 'email').

read-only

Argument	Type	Description
type	string	Only return templates of this type

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "type": {
      "enum": [
        "form",
        "email"
      ],
      "type": "string",
      "description": "Only return templates of this type"
    }
  }
}

list_workspace_members

List members and pending invitations of a workspace, including its owner.

read-only

Argument	Type	Description
workspaceId*	string	Workspace ID

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "workspaceId"
  ],
  "properties": {
    "workspaceId": {
      "type": "string",
      "description": "Workspace ID"
    }
  }
}

list_workspaces

List workspaces owned by or shared with the authenticated user.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

Argument	Type	Description
email*	string	Account email address
password*	string	Account password

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "email",
    "password"
  ],
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "Account email address"
    },
    "password": {
      "type": "string",
      "description": "Account password"
    }
  }
}

login_with_google

Log in or register using a Google Sign-In ID token credential. Stores the returned token for subsequent authenticated tool calls.

Argument	Type	Description
credential*	string	Google ID token credential

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "credential"
  ],
  "properties": {
    "credential": {
      "type": "string",
      "description": "Google ID token credential"
    }
  }
}

mark_submission_read

Mark a submission as read so it no longer shows as new.

Argument	Type	Description
id*	string	Submission ID

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Submission ID"
    }
  }
}

redeem_voucher

Redeem a voucher code to add submission quota to a workspace's owner.

Argument	Type	Description
id*	string	Workspace ID
code*	string	Voucher code to redeem

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id",
    "code"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Workspace ID"
    },
    "code": {
      "type": "string",
      "description": "Voucher code to redeem"
    }
  }
}

Argument	Type	Description
name	string	Display name of the user
email*	string	Email address for the new account
password*	string	Password for the new account

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "email",
    "password"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Display name of the user"
    },
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "Email address for the new account"
    },
    "password": {
      "type": "string",
      "description": "Password for the new account"
    }
  }
}

remove_workspace_member

Remove a member (or cancel a pending invitation) from a workspace. Requires admin access to the workspace.

destructive

Argument	Type	Description
memberId*	string	Member ID, as returned by list_workspace_members
workspaceId*	string	Workspace ID

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "workspaceId",
    "memberId"
  ],
  "properties": {
    "memberId": {
      "type": "string",
      "description": "Member ID, as returned by list_workspace_members"
    },
    "workspaceId": {
      "type": "string",
      "description": "Workspace ID"
    }
  }
}

resend_submission_email

Resend the email notification for a submission.

Argument	Type	Description
id*	string	Submission ID

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Submission ID"
    }
  }
}

set_auth_token

Set the bearer token (JWT from login/register, or a workspace API token starting with sk_) used to authenticate subsequent tool calls.

Argument	Type	Description
token*	string	JWT or workspace API token (sk_...)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "token"
  ],
  "properties": {
    "token": {
      "type": "string",
      "description": "JWT or workspace API token (sk_...)"
    }
  }
}

submit_demo

Trigger a demo submission email for marketing/demo purposes. No authentication required, rate-limited.

Argument	Type	Description
data	object	Example form field values to include in the demo email
email*	string	Email address that receives the demo notification

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "email"
  ],
  "properties": {
    "data": {
      "type": "object",
      "description": "Example form field values to include in the demo email",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "Email address that receives the demo notification"
    }
  }
}

submit_form

Submit data to a public form endpoint, as an end user would. No authentication required.

Argument	Type	Description
data*	object	Form field values, e.g. { "name": "Jane", "email": "[email protected]" }
formKey*	string	Public form key, as used in the /f/:formKey URL

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "formKey",
    "data"
  ],
  "properties": {
    "data": {
      "type": "object",
      "description": "Form field values, e.g. { \"name\": \"Jane\", \"email\": \"[email protected]\" }",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "formKey": {
      "type": "string",
      "description": "Public form key, as used in the /f/:formKey URL"
    }
  }
}

toggle_submission_archived

Flip a submission's archived state.

Argument	Type	Description
id*	string	Submission ID

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Submission ID"
    }
  }
}

toggle_submission_spam

Flip a submission's spam state.

Argument	Type	Description
id*	string	Submission ID

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Submission ID"
    }
  }
}

update_form

Update a form's settings (name, notification email, Slack webhook, redirect URL, custom HTML, active state, or arbitrary settings).

Argument	Type	Description
id*	string	Form ID or form key
name	string	New name of the form
email_to	string	Notification email recipient
settings	object	Additional form settings to merge
is_active	boolean	Whether the form accepts submissions
custom_html	string	Custom HTML for the public form page; {{form_url}} is replaced with the submission endpoint
redirect_url	string	URL to redirect submitters to after a successful submission
slack_webhook	string	Slack incoming webhook URL for submission notifications

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Form ID or form key"
    },
    "name": {
      "type": "string",
      "description": "New name of the form"
    },
    "email_to": {
      "type": "string",
      "description": "Notification email recipient"
    },
    "settings": {
      "type": "object",
      "description": "Additional form settings to merge",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "is_active": {
      "type": "boolean",
      "description": "Whether the form accepts submissions"
    },
    "custom_html": {
      "type": "string",
      "description": "Custom HTML for the public form page; {{form_url}} is replaced with the submission endpoint"
    },
    "redirect_url": {
      "type": "string",
      "description": "URL to redirect submitters to after a successful submission"
    },
    "slack_webhook": {
      "type": "string",
      "description": "Slack incoming webhook URL for submission notifications"
    }
  }
}

update_member_role

Change a workspace member's role. Requires admin access to the workspace.

Argument	Type	Description
role*	string	New role, e.g. 'admin' or 'member'
memberId*	string	Member ID, as returned by list_workspace_members
workspaceId*	string	Workspace ID

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "workspaceId",
    "memberId",
    "role"
  ],
  "properties": {
    "role": {
      "type": "string",
      "description": "New role, e.g. 'admin' or 'member'"
    },
    "memberId": {
      "type": "string",
      "description": "Member ID, as returned by list_workspace_members"
    },
    "workspaceId": {
      "type": "string",
      "description": "Workspace ID"
    }
  }
}

update_template_admin

Update a template. Requires super-admin.

Argument	Type	Description
id*	string	Template ID
name	string	Template name
slug	string	URL-friendly identifier for the template
type	string	Template type
content	string	Template HTML content
is_default	boolean	Whether the template is offered to all users by default
description	string	Short description of the template

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Template ID"
    },
    "name": {
      "type": "string",
      "description": "Template name"
    },
    "slug": {
      "type": "string",
      "description": "URL-friendly identifier for the template"
    },
    "type": {
      "enum": [
        "form",
        "email"
      ],
      "type": "string",
      "description": "Template type"
    },
    "content": {
      "type": "string",
      "description": "Template HTML content"
    },
    "is_default": {
      "type": "boolean",
      "description": "Whether the template is offered to all users by default"
    },
    "description": {
      "type": "string",
      "description": "Short description of the template"
    }
  }
}

update_user_plan_admin

Set a user's plan ('free' or 'pro') and its associated quota. Requires super-admin.

Argument	Type	Description
id*	string	User ID
plan*	string	Plan to assign

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id",
    "plan"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "User ID"
    },
    "plan": {
      "enum": [
        "free",
        "pro"
      ],
      "type": "string",
      "description": "Plan to assign"
    }
  }
}

update_user_quota_admin

Set a user's submission quota directly. Requires super-admin.

Argument	Type	Description
id*	string	User ID
submission_quota*	number	New submission quota

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id",
    "submission_quota"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "User ID"
    },
    "submission_quota": {
      "type": "number",
      "description": "New submission quota"
    }
  }
}

update_user_role_admin

Grant or revoke super-admin status for a user. Requires super-admin.

Argument	Type	Description
id*	string	User ID
is_super_admin*	boolean	true to grant super-admin, false to revoke

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id",
    "is_super_admin"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "User ID"
    },
    "is_super_admin": {
      "type": "boolean",
      "description": "true to grant super-admin, false to revoke"
    }
  }
}

update_workspace

Rename a workspace or change its settings.

Argument	Type	Description
id*	string	Workspace ID
name	string	New workspace name
settings	object	Workspace settings to merge

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Workspace ID"
    },
    "name": {
      "type": "string",
      "description": "New workspace name"
    },
    "settings": {
      "type": "object",
      "description": "Workspace settings to merge",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    }
  }
}

upgrade_user_plan

Change the authenticated user's plan (defaults to 'pro' if not specified).

Argument	Type	Description
plan	string	Plan to switch to, e.g. 'pro' (default)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "plan": {
      "type": "string",
      "description": "Plan to switch to, e.g. 'pro' (default)"
    }
  }
}