JotForm API

Provides an MCP server to access JotForm data and actions via standardized tools (forms, submissions, user settings, and more).

python

GitHub Stars

python

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "the-ai-workshops-jotform-mcp-server": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@smithery/cli@latest",
        "run",
        "@The-AI-Workshops/jotform-mcp-server",
        "--key",
        "{\"method\":\"initialize\",\"params\":{\"protocolVersion\":\"2024-11-05\",\"capabilities\":{},\"clientInfo\":{\"name\":\"claude-ai\",\"version\":\"0.1.0\"}},\"jsonrpc\":\"2.0\",\"id\":0}",
        "--config",
        "\"{\\\"apiKey\\\":\\\"YOUR_JOTFORM_API_KEY\\\",\\\"baseUrl\\\":\\\"https://api.jotform.com/\\\",\\\"mcpHost\\\":\\\"0.0.0.0\\\",\\\"mcpPort\\\":\\\"8067\\\",\\\"debugMode\\\":\\\"False\\\",\\\"transport\\\":\\\"stdio\\\",\\\"outputType\\\":\\\"json\\\"}\""
      ],
      "env": {
        "MCP_HOST": "0.0.0.0",
        "MCP_PORT": "8067",
        "JOTFORM_API_KEY": "YOUR_JOTFORM_API_KEY",
        "JOTFORM_BASE_URL": "https://api.jotform.com/"
      }
    }
  }
}

You run the JotForm MCP Server to access JotForm data through standardized MCP tools. This server wraps the JotForm API in a consistent interface so you can query forms, submissions, settings, and more from your MCP client without writing direct API calls.

How to use

Connect to the JotForm MCP Server from your MCP client using a stdio or SSE-based transport, then explore the built-in tools to manage forms, submissions, and user data. You can perform common tasks such as listing forms, retrieving form questions, submitting new data, managing folders, and querying usage statistics. Use the client to run operations across your JotForm account with programmatic control and automation.

How to install

Prerequisites: a supported MCP client, Python 3.11+, and optional tools depending on your setup (Docker, uv, Node/npm). You will also need your JotForm API key.

Additional steps and configuration

Choose a running approach for the MCP server and supply your JotForm API key in the environment. The available options include using Smithery to install the server, running directly with Python, using a virtual environment, or running via uv. Each approach requires you to provide the key and, optionally, customize transport settings and base URL.

Security and best practices

Treat your JotForm API key as a secret. Do not commit keys to source control. Use environment variables to inject the key into your server or client configurations. Restrict access to the MCP port to trusted clients and consider enabling transport security when available.

Troubleshooting and notes

If the server does not start, verify that the JOTFORM_API_KEY environment variable is set and that the port specified for MCP transport is open. Check the logs for authentication errors or transport configuration issues and adjust the environment values accordingly.

Available tools

get_user

Retrieve user account details.

get_usage

Fetch monthly usage statistics including submissions and uploads.

get_submissions

List submissions for the account with pagination and filters.

get_subusers

List sub users linked to the main account.

get_settings

Fetch user settings such as timezone and language.

update_settings

Update user settings.

get_history

Retrieve user activity history.

register_user

login_user

Authenticate a user and obtain session details.

logout_user

End the user session.

get_forms

List forms for the account with pagination and filters.

get_form

Get basic information about a specific form.

get_form_questions

List all questions on a form.

get_form_question

Get details about a specific form question.

create_form

Create a new form.

create_forms

Create multiple new forms.

delete_form

Delete a specific form.

clone_form

Clone a single form.

delete_form_question

Delete a form question.

create_form_question

Add a new question to a form.

create_form_questions

Add multiple questions to a form.

edit_form_question

Add or edit properties of a form question.

get_form_properties

Get all properties of a form.

get_form_property

Get a specific property of a form.

set_form_properties

Add or edit properties of a form.

set_multiple_form_properties

Add or edit multiple form properties.

get_form_files

List files uploaded to a form.

get_form_webhooks

Get webhooks for a form.

create_form_webhook

Add a webhook to a form.

delete_form_webhook

Delete a webhook from a form.

get_form_reports

Get all reports for a form.

create_report

Create a new report for a form.

get_submissions_by_date

Search submissions across forms by date range or predefined periods.

get_submission

Get data for a specific submission.

delete_submission

Delete a specific submission.

edit_submission

Edit a submission.

get_folders

List form folders.

get_folder

Get details of a folder.

create_folder

Create a new folder.

delete_folder

Delete a folder and its subfolders.

update_folder

Update folder properties.

add_forms_to_folder

Add multiple forms to a folder.

add_form_to_folder

Add a single form to a folder.

get_reports

List all reports for the account.

get_report

Get details of a specific report.

delete_report

Delete a specific report.

get_plan

Get details of the current JotForm plan.

search_submissions_by_date

Custom tool to search submissions by date with various filters and accounting period support.

Built by

VeilStrat

AI signals for GTM teams