SubmitraX
Form backend for static sites: create forms, manage submissions, webhooks and exports.
Should I use this
Quality & Safety
Findings (6)
- LOWin accept_invite
- LOWin upgrade_user_plan
- LOWin submit_demo
- LOWin toggle_submission_archived
- LOWin toggle_submission_spam
- LOWin bulk_archive_submissions
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"mcp": {
"url": "https://mcp.submitrax.com/mcp"
}
}
}Remote endpoints
https://mcp.submitrax.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (57)
🟡set_auth_token(token)
Set the bearer token (JWT from login/register, or a workspace API token starting with sk_) used to authenticate subsequent tool calls.
Input Schema
{
"type": "object",
"properties": {
"token": {
"type": "string",
"description": "JWT or workspace API token (sk_...)"
}
},
"required": [
"token"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_auth_status
Check whether an auth token is currently configured for this session.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}⚪register(email, password, name)
Register a new SubmitraX user account. Stores the returned token for subsequent authenticated tool calls.
Input Schema
{
"type": "object",
"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": "Email address for the new account"
},
"password": {
"type": "string",
"description": "Password for the new account"
},
"name": {
"description": "Display name of the user",
"type": "string"
}
},
"required": [
"email",
"password"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}⚪login(email, password)
Log in with email and password. Stores the returned token for subsequent authenticated tool calls.
Input Schema
{
"type": "object",
"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"
}
},
"required": [
"email",
"password"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}⚪login_with_google(credential)
Log in or register using a Google Sign-In ID token credential. Stores the returned token for subsequent authenticated tool calls.
Input Schema
{
"type": "object",
"properties": {
"credential": {
"type": "string",
"description": "Google ID token credential"
}
},
"required": [
"credential"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_current_user
Get the profile of the currently authenticated user.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}⚪accept_invite(token)
Accept a pending workspace invitation using its invitation token, linking it to the authenticated user.
Input Schema
{
"type": "object",
"properties": {
"token": {
"type": "string",
"description": "Invitation token from the invite email link"
}
},
"required": [
"token"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟡upgrade_user_plan(plan)
Change the authenticated user's plan (defaults to 'pro' if not specified).
Input Schema
{
"type": "object",
"properties": {
"plan": {
"description": "Plan to switch to, e.g. 'pro' (default)",
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_public_form_html(formKey)
Fetch the rendered public HTML (custom or default template) for a form by its form key. No authentication required.
Input Schema
{
"type": "object",
"properties": {
"formKey": {
"type": "string",
"description": "Public form key, as used in the /f/:formKey URL"
}
},
"required": [
"formKey"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢list_forms(workspace_id)
List forms across the user's workspaces, or within one workspace if workspace_id is given.
Input Schema
{
"type": "object",
"properties": {
"workspace_id": {
"description": "Only include this workspace",
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟡create_form(name, workspace_id, email_to, custom_html)
Create a new form in a workspace.
Input Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Name of the form"
},
"workspace_id": {
"type": "string",
"description": "ID of the workspace to create the form in"
},
"email_to": {
"description": "Notification email recipient. Defaults to the authenticated user's email",
"type": "string"
},
"custom_html": {
"description": "Custom HTML for the public form page; {{form_url}} is replaced with the submission endpoint",
"type": "string"
}
},
"required": [
"name",
"workspace_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_form(id)
Get a single form by id or form key.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Form ID or form key"
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟡update_form(id, name, email_to, slack_webhook, redirect_url, ...)
Update a form's settings (name, notification email, Slack webhook, redirect URL, custom HTML, active state, or arbitrary settings).
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Form ID or form key"
},
"name": {
"description": "New name of the form",
"type": "string"
},
"email_to": {
"description": "Notification email recipient",
"type": "string"
},
"slack_webhook": {
"description": "Slack incoming webhook URL for submission notifications",
"type": "string"
},
"redirect_url": {
"description": "URL to redirect submitters to after a successful submission",
"type": "string"
},
"custom_html": {
"description": "Custom HTML for the public form page; {{form_url}} is replaced with the submission endpoint",
"type": "string"
},
"is_active": {
"description": "Whether the form accepts submissions",
"type": "boolean"
},
"settings": {
"description": "Additional form settings to merge",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🔴delete_form(id)
Delete a form.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Form ID or form key"
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢list_form_webhooks(id)
List the notification webhook URLs (Slack, Discord, generic) configured on a form.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Form ID or form key"
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟡add_form_webhook(id, url)
Add a notification webhook URL to a form.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Form ID or form key"
},
"url": {
"type": "string",
"description": "Webhook URL (Slack, Discord, or generic HTTP endpoint)"
}
},
"required": [
"id",
"url"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🔴delete_form_webhook(id, url)
Remove a notification webhook URL from a form.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Form ID or form key"
},
"url": {
"type": "string",
"description": "Webhook URL (Slack, Discord, or generic HTTP endpoint)"
}
},
"required": [
"id",
"url"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟡submit_form(formKey, data)
Submit data to a public form endpoint, as an end user would. No authentication required.
Input Schema
{
"type": "object",
"properties": {
"formKey": {
"type": "string",
"description": "Public form key, as used in the /f/:formKey URL"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Form field values, e.g. { \"name\": \"Jane\", \"email\": \"[email protected]\" }"
}
},
"required": [
"formKey",
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟡submit_demo(email, data)
Trigger a demo submission email for marketing/demo purposes. No authentication required, rate-limited.
Input Schema
{
"type": "object",
"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": "Email address that receives the demo notification"
},
"data": {
"description": "Example form field values to include in the demo email",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"email"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢list_form_submissions(formId)
List all submissions for a specific form.
Input Schema
{
"type": "object",
"properties": {
"formId": {
"type": "string",
"description": "Form ID"
}
},
"required": [
"formId"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢list_submissions(workspace_id)
List submissions across the user's workspaces, or within one workspace if workspace_id is given.
Input Schema
{
"type": "object",
"properties": {
"workspace_id": {
"description": "Only include this workspace",
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢mark_submission_read(id)
Mark a submission as read so it no longer shows as new.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Submission ID"
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}⚪toggle_submission_archived(id)
Flip a submission's archived state.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Submission ID"
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}⚪toggle_submission_spam(id)
Flip a submission's spam state.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Submission ID"
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}⚪resend_submission_email(id)
Resend the email notification for a submission.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Submission ID"
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🔴delete_submission(id)
Permanently delete a single submission.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Submission ID"
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🔴delete_all_form_submissions(formId)
Delete every submission belonging to a form.
Input Schema
{
"type": "object",
"properties": {
"formId": {
"type": "string",
"description": "Form ID"
}
},
"required": [
"formId"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}⚪bulk_archive_submissions(submissionIds)
Archive several submissions at once.
Input Schema
{
"type": "object",
"properties": {
"submissionIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "IDs of the submissions to process"
}
},
"required": [
"submissionIds"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🔴bulk_delete_submissions(submissionIds)
Permanently delete several submissions at once.
Input Schema
{
"type": "object",
"properties": {
"submissionIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "IDs of the submissions to process"
}
},
"required": [
"submissionIds"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢list_workspaces
List workspaces owned by or shared with the authenticated user.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟡create_workspace(name)
Create a new workspace owned by the authenticated user.
Input Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Name of the workspace"
}
},
"required": [
"name"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_workspace(id)
Get a single workspace's details and settings.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Workspace ID"
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟡update_workspace(id, name, settings)
Rename a workspace or change its settings.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Workspace ID"
},
"name": {
"description": "New workspace name",
"type": "string"
},
"settings": {
"description": "Workspace settings to merge",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🔴delete_workspace(id)
Delete a workspace along with all its forms and submissions. Only the owner may do this.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Workspace ID"
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟡redeem_voucher(id, code)
Redeem a voucher code to add submission quota to a workspace's owner.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Workspace ID"
},
"code": {
"type": "string",
"description": "Voucher code to redeem"
}
},
"required": [
"id",
"code"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}⚪generate_workspace_api_token(id)
Generate (or reset) a long-lived API token (sk_...) scoped to a single workspace, for use with public API integrations.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Workspace ID"
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢list_workspace_members(workspaceId)
List members and pending invitations of a workspace, including its owner.
Input Schema
{
"type": "object",
"properties": {
"workspaceId": {
"type": "string",
"description": "Workspace ID"
}
},
"required": [
"workspaceId"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}⚪invite_workspace_member(workspaceId, theirName, theirEmail, yourName)
Invite a new member to a workspace by email. Requires admin access to the workspace.
Input Schema
{
"type": "object",
"properties": {
"workspaceId": {
"type": "string",
"description": "Workspace ID"
},
"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"
},
"yourName": {
"type": "string",
"description": "Name of the inviter, shown in the invitation email"
}
},
"required": [
"workspaceId",
"theirName",
"theirEmail",
"yourName"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟡update_member_role(workspaceId, memberId, role)
Change a workspace member's role. Requires admin access to the workspace.
Input Schema
{
"type": "object",
"properties": {
"workspaceId": {
"type": "string",
"description": "Workspace ID"
},
"memberId": {
"type": "string",
"description": "Member ID, as returned by list_workspace_members"
},
"role": {
"type": "string",
"description": "New role, e.g. 'admin' or 'member'"
}
},
"required": [
"workspaceId",
"memberId",
"role"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🔴remove_workspace_member(workspaceId, memberId)
Remove a member (or cancel a pending invitation) from a workspace. Requires admin access to the workspace.
Input Schema
{
"type": "object",
"properties": {
"workspaceId": {
"type": "string",
"description": "Workspace ID"
},
"memberId": {
"type": "string",
"description": "Member ID, as returned by list_workspace_members"
}
},
"required": [
"workspaceId",
"memberId"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢list_templates(type)
List default templates available to all users, optionally filtered by type ('form' or 'email').
Input Schema
{
"type": "object",
"properties": {
"type": {
"description": "Only return templates of this type",
"type": "string",
"enum": [
"form",
"email"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢list_all_templates_admin(page, limit, type)
Paginated list of every template. Requires super-admin.
Input Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page number, starting at 1",
"type": "number"
},
"limit": {
"description": "Number of templates per page",
"type": "number"
},
"type": {
"description": "Only return templates of this type",
"type": "string",
"enum": [
"form",
"email"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟡create_template_admin(name, type, content, is_default, description, ...)
Create a new template. Requires super-admin.
Input Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Template name"
},
"type": {
"type": "string",
"enum": [
"form",
"email"
],
"description": "Template type"
},
"content": {
"type": "string",
"description": "Template HTML content"
},
"is_default": {
"description": "Whether the template is offered to all users by default",
"type": "boolean"
},
"description": {
"description": "Short description of the template",
"type": "string"
},
"slug": {
"description": "URL-friendly identifier for the template",
"type": "string"
}
},
"required": [
"name",
"type",
"content"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟡update_template_admin(id, name, type, content, is_default, ...)
Update a template. Requires super-admin.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Template ID"
},
"name": {
"description": "Template name",
"type": "string"
},
"type": {
"description": "Template type",
"type": "string",
"enum": [
"form",
"email"
]
},
"content": {
"description": "Template HTML content",
"type": "string"
},
"is_default": {
"description": "Whether the template is offered to all users by default",
"type": "boolean"
},
"description": {
"description": "Short description of the template",
"type": "string"
},
"slug": {
"description": "URL-friendly identifier for the template",
"type": "string"
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🔴delete_template_admin(id)
Delete a template. Requires super-admin.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Template ID"
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟡create_checkout_session(planType, billingPeriod)
Start a Stripe subscription checkout for a plan ('free', 'essentials', 'pro'). Downgrades immediately if planType is 'free'.
Input Schema
{
"type": "object",
"properties": {
"planType": {
"type": "string",
"enum": [
"free",
"essentials",
"pro"
],
"description": "Plan to subscribe to"
},
"billingPeriod": {
"description": "Billing period for paid plans",
"type": "string",
"enum": [
"monthly",
"annual"
]
}
},
"required": [
"planType"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢list_admin_users(page, limit)
Paginated list of all users with plan stats. Requires super-admin.
Input Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page number, starting at 1",
"type": "number"
},
"limit": {
"description": "Number of users per page",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟡update_user_role_admin(id, is_super_admin)
Grant or revoke super-admin status for a user. Requires super-admin.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "User ID"
},
"is_super_admin": {
"type": "boolean",
"description": "true to grant super-admin, false to revoke"
}
},
"required": [
"id",
"is_super_admin"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟡update_user_plan_admin(id, plan)
Set a user's plan ('free' or 'pro') and its associated quota. Requires super-admin.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "User ID"
},
"plan": {
"type": "string",
"enum": [
"free",
"pro"
],
"description": "Plan to assign"
}
},
"required": [
"id",
"plan"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟡update_user_quota_admin(id, submission_quota)
Set a user's submission quota directly. Requires super-admin.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "User ID"
},
"submission_quota": {
"type": "number",
"description": "New submission quota"
}
},
"required": [
"id",
"submission_quota"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🔴delete_user_admin(id)
Delete a single user account. Requires super-admin.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "User ID"
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🔴bulk_delete_users_admin(userIds)
Delete multiple user accounts at once. Requires super-admin.
Input Schema
{
"type": "object",
"properties": {
"userIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "IDs of the users to delete"
}
},
"required": [
"userIds"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}⚪generate_ai_content(payload)
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.
Input Schema
{
"type": "object",
"properties": {
"payload": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Arbitrary JSON payload forwarded to the AI generation webhook"
}
},
"required": [
"payload"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟡create_export(formId, format, start_date, end_date)
Create a CSV or JSON export of a form's submissions, optionally filtered by date range (YYYY-MM-DD).
Input Schema
{
"type": "object",
"properties": {
"formId": {
"type": "string",
"description": "Form ID"
},
"format": {
"description": "Export file format",
"type": "string",
"enum": [
"csv",
"json"
]
},
"start_date": {
"description": "Only include submissions from this date (YYYY-MM-DD)",
"type": "string"
},
"end_date": {
"description": "Only include submissions up to this date (YYYY-MM-DD)",
"type": "string"
}
},
"required": [
"formId"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢list_form_exports(formId)
List the export files previously created for a form.
Input Schema
{
"type": "object",
"properties": {
"formId": {
"type": "string",
"description": "Form ID"
}
},
"required": [
"formId"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢download_export(filename)
Download the contents of a previously created export file (CSV or JSON text).
Input Schema
{
"type": "object",
"properties": {
"filename": {
"type": "string",
"description": "The export filename, as returned by create_export or list_form_exports"
}
},
"required": [
"filename"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢health_check
Check whether the SubmitraX API is reachable and running.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"data": {
"description": "Response body returned by the SubmitraX API"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Community
Evidence