# JotForm MCP

> JotForm MCP Server connects your AI client to the JotForm API. You can manage forms, track submissions, and audit account activity directly through natural language prompts. Use the server to list forms, retrieve submissions for analysis, or check account usage limits. It's built for automating data collection and form management workflows.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** form-builder, data-collection, submissions, automation, reporting

## Description

Your AI client connects to the JotForm API through this server. You'll manage forms, track submissions, and audit your account right from your agent. **get_account** gives you the detailed status and identity of your JotForm account. **get_usage** checks your current account capacity and usage limits. **list_history** shows a timeline of every account action and usage event. **list_folders** lists the organizational folders you use to group forms. **list_forms** gives you a full list of every form in your account, showing the titles, IDs, and how many responses each one got. **get_form** returns the specific questions and properties for a form ID, telling you exactly what data that form collects. **get_form_submissions** fetches every single response for a specific form, letting you analyze the collected data deep down. **list_submissions** lists all submission records from every form in your account. You can also **list_reports** to see all the pre-aggregated reports generated from your data. **list_webhooks** lists the webhooks set up for a form, which is handy if you're debugging automation. Finally, **list_history** gives you a chronological record of all account management actions and usage history.

## Tools

### get_account
Retrieves detailed information about your JotForm account status or identity.

### get_form
Returns the questions and properties of a specific form ID, showing exactly what data it collects.

### get_form_submissions
Retrieves all individual responses for a specific form, allowing deep analysis of its results.

### get_usage
Retrieves your current account usage limits and capacity status.

### list_folders
Lists the organizational folders used to group and manage forms in your account.

### list_forms
Lists all forms in your JotForm account, providing titles, IDs, and response counts.

### list_history
Lists a chronological record of all account management actions and usage history.

### list_reports
Lists all pre-aggregated reports generated from your form data.

### list_submissions
Lists all submission records across every form in your account.

### list_webhooks
Lists the webhooks configured for a specific form, useful for debugging automation flows.

## Prompt Examples

**Prompt:** 
```
List all active forms in my JotForm account.
```

**Response:** 
```
I'll fetch the list of available forms from your JotForm account.
```

**Prompt:** 
```
Show me the submissions for form ID '123'.
```

**Response:** 
```
I'll retrieve the submissions for that specific form from JotForm.
```

**Prompt:** 
```
Check my account usage limits.
```

**Response:** 
```
I'll look up the usage statistics and limits for your JotForm account.
```

## Capabilities

### Get Form Data
Retrieves the structure and questions of a specific JotForm, telling you exactly what data the form collects.

### Fetch Submissions
Gathers all individual responses (submissions) for a specified form, allowing deep analysis of collected data.

### List Forms and Folders
Provides an inventory of all available forms and the folders they are stored in, helping you navigate large accounts.

### Check Account Status
Verifies your JotForm account details, including usage limits and historical activity logs, so you know your account health.

### Monitor Global Activity
Lists all submissions across every form or provides a general view of account activity for quick monitoring.

## Use Cases

### Analyzing a Campaign's Results
A marketing analyst needs to understand the results of a recent survey. They ask their agent to run `list_forms` first to identify the correct ID. Then, they call `get_form_submissions` with that ID. The agent pulls all the raw data, which the analyst can then summarize and send to the stakeholder.

### Building a Master Data Feed
An ops engineer needs a single feed of all incoming leads, regardless of which form they used. They use `list_submissions` to get a master list of all recent entries. This feed bypasses the need to query every form's submission dashboard individually.

### Compliance and Auditing
A compliance officer needs proof of who changed settings and when. They use `list_history` to pull the full audit log. This ensures full data lineage tracking, a manual task that takes hours otherwise.

### Debugging Broken Integrations
A developer notices a form isn't triggering its webhook. Instead of guessing, they use `list_webhooks` on the form ID. This instantly shows the configured endpoints, letting them fix the automation flow quickly.

## Benefits

- **Access Specific Form Data:** Instead of navigating to a single form's dashboard, use `get_form_submissions` to pull all responses for a given form ID instantly. This speeds up analysis cycles and eliminates manual data export.
- **Map Out Your Data Inventory:** Need to know which forms exist? Use `list_forms` or `list_folders` to get a full inventory of your JotForm account. This is better than manually checking folder names and is critical for initial data mapping.
- **Audit Account Health:** Before running large data queries, check your limits. The `get_usage` tool tells you exactly if you're approaching your plan capacity, stopping failed jobs before they start.
- **Centralized Submission View:** Don't want to filter by form? `list_submissions` gives you a master list of every entry across your entire account, perfect for high-level monitoring.
- **Trace Account Changes:** Need to know who did what and when? `list_history` provides an audit log of all management actions, which is essential for compliance and debugging.
- **Check Automation Status:** If a form isn't sending data where it should, use `list_webhooks` to see the configured automation triggers and debug the flow.

## How It Works

The bottom line is, you ask your agent for data, and the server delivers the structured API results directly to your workflow.

1. You ask your AI client to check for form submissions. It uses the `list_forms` tool to get a list of available forms and their IDs.
2. You then specify the exact form ID and ask for the results. The agent calls `get_form_submissions` with that ID.
3. The server returns the raw submission data, which your AI client then structures, summarizes, or sends elsewhere.

## Frequently Asked Questions

**How do I list all my active forms using the JotForm MCP Server?**
You run the `list_forms` tool. This returns a list of every form ID and title in your account, which is the first step before fetching any data.

**What is the difference between `list_submissions` and `get_form_submissions`?**
`list_submissions` gives you a general list of all entries across all forms. `get_form_submissions` drills down to get every single submission for one specific form ID.

**Can I check my JotForm account usage with the `get_usage` tool?**
Yes. Running `get_usage` retrieves your current account usage limits and tells you if you're approaching capacity, helping prevent failed data jobs.

**How do I find out what data a form collects before I analyze it?**
Run the `get_form` tool. It returns the form's properties and the list of questions/fields, so you know exactly what data is available.

**Does the JotForm MCP Server handle form authentication?**
The server interacts with the JotForm API to manage data. Your AI client handles the authentication flow required to access the necessary tools.

**How do I check the history of actions with the `list_history` tool?**
The `list_history` tool provides an audit log of account activity. You can use this to review recent management actions and track who did what within your JotForm account.

**What is the difference between `list_forms` and `get_form`?**
The `list_forms` tool returns a summary of all your forms (titles, IDs, and counts). Use `get_form` when you need the specific details, like the questions and fields, for one particular form ID.

**How can I find all submissions across different forms using `list_submissions`?**
The `list_submissions` tool gathers all entries from every form into one view. This is ideal for monitoring general activity or gathering recent data across multiple, unrelated forms.

**How do I get JotForm API credentials?**
Log in to your JotForm account, navigate to Account Settings > API, and create a new API Key.

**Can I see form questions?**
Yes, the get_form tool retrieves the full structure and details of a specific form, including its questions.

**Does it support submission tracking?**
Yes, you can list all submissions or retrieve submissions for a specific form using the corresponding tools.