Connect AI agents to the Jotform MCP server

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node dotenv

   Python

   pip install scalekit-sdk-python python-dotenv

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .env

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Authorize and make your first call

   Node.js

   quickstart.mts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'jotformmcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Jotform MCP:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'jotformmcp_fetch',
     toolInput: { id: 'YOUR_ID' },
   })
   console.log(result)

   npx tsx quickstart.mts

   Python

   quickstart.py

   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "jotformmcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Jotform MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={"id":"YOUR_ID"},
       tool_name="jotformmcp_fetch",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

   python quickstart.py

What you can do

Connect this agent connector to let your agent:

• Search records — Search Jotform assets by query with optional filters, ordering, and limit
• Get submissions — List submission IDs for a form with optional filters
• Fetch records — Fetch metadata and information for a Jotform form by its ID or URL
• Form edit, assign — Edit an existing form using a natural-language instruction
• Create form — Create a new Jotform form based on a natural-language description
• Submissions analyze — Perform AI-powered analysis on one or more forms’ submissions using a natural-language query

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

jotformmcp_analyze_submissions#Perform AI-powered analysis on one or more forms' submissions using a natural-language query.3 params▾

Perform AI-powered analysis on one or more forms' submissions using a natural-language query.

NameTypeRequiredDescription

analysisQuerystringrequiredA natural-language query describing the desired analysis. Examples: "What are the most common responses?", "Show submission trends by month", "Analyze sentiment in feedback", "Give me a statistical breakdown of all answers".

formIDsarrayrequiredForm IDs whose submissions will be analyzed. Provide a single form ID by default. Only supply more than one ID when the user explicitly requests cross-form comparison or combined analysis. Use the search_asset tool first if you need to find the form ID.

limitnumberrequiredMaximum number of submissions to include in the analysis. Higher values provide more comprehensive results but increase processing time.

jotformmcp_assign_form#Assign a form to a user by email address with an optional message.4 params▾

Assign a form to a user by email address with an optional message.

NameTypeRequiredDescription

assignee_emailstringrequiredThe email address to assign the form to

assignee_messagestringrequiredThe message to assign the form to. This will be used in the email that will be sent to the assignee.

assignee_namestringrequiredThe name of the assignee. This will be used in the email that will be sent to the assignee.

form_idstringrequiredThe ID of the form to assign

jotformmcp_create_form#Create a new Jotform form based on a natural-language description.1 param▾

Create a new Jotform form based on a natural-language description.

NameTypeRequiredDescription

descriptionstringrequiredDescription of the form to create

jotformmcp_edit_form#Edit an existing form using a natural-language instruction.2 params▾

Edit an existing form using a natural-language instruction.

NameTypeRequiredDescription

descriptionstringrequiredHigh-level natural-language instruction describing what to change (e.g., add/move/rename questions). Avoid specifying internal types or identifiers; another agent will infer the appropriate field types.

form_idstringrequiredThe ID of the form to edit

jotformmcp_fetch#Fetch metadata and information for a Jotform form by its ID or URL.1 param▾

Fetch metadata and information for a Jotform form by its ID or URL.

NameTypeRequiredDescription

idstringrequiredThe form id or the submission id to fetch information and metadata from

jotformmcp_get_submissions#List submission IDs for a form with optional filters.2 params▾

List submission IDs for a form with optional filters.

NameTypeRequiredDescription

filterobjectrequiredNo description.

form_idstringrequiredThe ID of the form to list submissions from

jotformmcp_search#Search Jotform assets by query with optional filters, ordering, and limit.4 params▾

Search Jotform assets by query with optional filters, ordering, and limit.

NameTypeRequiredDescription

filterobjectrequiredNo description.

limitnumberrequiredMaximum items fetched per underlying request (default: 20).

order_bystringrequiredSort order for the results. The default value is "last_activity", only use another option if a sorting is really needed.

user_querystringrequiredA natural-language instruction describing what the user wants to find and list from assets.