# Cognito Forms MCP MCP

> Cognito Forms MCP lets your AI agent fully manage data collection workflows by treating form submissions like a database. You can programmatically list forms, pull full schemas, search for specific entries across large datasets, and even create or update records without touching the web portal.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** form-builder, data-collection, conditional-logic, workflow-automation, submission-management, validation

## Description

Building smart online forms is only half the battle; managing the resulting flood of data is where the real work happens. This MCP connects your AI client directly to the core functions of Cognito Forms, letting you treat every form submission as structured data that can be manipulated conversationally.

Forget manually exporting entries or hunting through nested folders in the web portal. Your agent becomes a dedicated operations analyst for your forms. You can programmatically list and manage all active and archived forms, get the detailed structure (JSON schema) of any form to understand its fields, and access submissions in real-time. If you need to accelerate lead capture or data ingestion, your AI client can create new entries directly. The entire process runs safely because credentials pass through a zero-trust proxy when they move between Vinkius and Cognito Forms; your keys never sit on disk.

The power is using this MCP to combine form intelligence with other systems. You're not just reading data—you're coordinating it. It lets you monitor form volume, retrieve specific submission details for instant reporting, or even search entries across an entire organization by natural language query.

## Tools

### check_cognito_status
Verifies the current connection status and connectivity between your AI agent and Cognito Forms.

### create_entry
Generates and submits a completely new form entry using data provided by your agent.

### delete_entry
Removes an existing, specified form submission record from the system.

### get_entry
Retrieves all specific data points for a single, known form entry ID.

### get_form
Fetches the overall metadata and details for an entire form project.

### get_form_fields
Lists the exact field names, types, and validation rules used by a specific form.

### list_entries
Retrieves lists of multiple submitted entries for a given form ID or scope.

### list_forms
Returns a list of all available forms and templates within the organization's account.

### list_organizations
Lists all organizational accounts or scopes connected to the Cognito Forms environment.

### list_templates
Retrieves a list of available form templates that can be used as starting points for new forms.

### search_entries
Searches across multiple entries using flexible text queries to find relevant submissions.

### update_entry
Modifies specific data points on an existing form entry without deleting the original record.

## Prompt Examples

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

**Response:** 
```
I've retrieved your forms. You currently have 3 active projects: 'Customer Support' (ID: support-v1), 'Sales Intake', and 'Feedback Survey'. Which one would you like to see the entries for?
```

**Prompt:** 
```
Show the last 5 entries for the 'Sales Intake' form.
```

**Response:** 
```
Fetching entries... I found 5 recent submissions for 'Sales Intake'. Highlights include a new lead from @user1 and a pricing inquiry. Would you like the detailed field values for the latest lead?
```

**Prompt:** 
```
Get the JSON schema for form ID 'feedback-survey'.
```

**Response:** 
```
I've retrieved the schema for 'feedback-survey'. The form expects 4 main fields: 'Rating' (Numeric), 'Comments' (Long Text), 'Email', and 'SubmitDate'. I'm ready to create a new entry for you.
```

## Capabilities

### List and check forms
Fetch a list of all your active and archived forms in the account.

### Inspect form structure
Retrieve the complete JSON schema for any specific form, showing exactly what fields it expects.

### Fetch submission data
Get detailed information on a single form entry based on its unique ID.

### Search submissions by criteria
Find specific entries across multiple forms using flexible, natural language search parameters.

### Generate new records
Create a brand-new form entry directly from your AI agent's output, bypassing manual submission steps.

## Use Cases

### Auditing Form Changes
A compliance officer needs to know if any sensitive data was recorded on an old form. Instead of checking the portal, they ask their agent to run `search_entries` across all forms for specific keywords, instantly providing a list of matching records.

### Automated Lead Follow-up
A sales workflow needs to trigger when a form is submitted. The system first checks the full schema using `get_form` and then uses that knowledge base to build an automated message via another MCP, guaranteeing all required fields are present.

### Data Correction
A user spots a typo in a critical client record. Instead of requesting manual corrections, the agent runs `get_entry` to confirm the current data, and then uses `update_entry` to fix the specific field value.

### Inventory Management
The dev team needs a list of all available forms for a new client integration. They simply ask their agent to run `list_forms`, receiving an immediate, structured list of IDs and names.

## Benefits

- Never manually search for data again. Use `search_entries` to pull up submissions from across different forms using natural language queries.
- Stop wasting time on manual exports. Your agent can instantly fetch the JSON schema (`get_form_fields`) so you know exactly what fields are available before writing any code.
- Speed up your data pipelines by letting your AI client use `create_entry` to generate and submit records directly, bypassing form builders entirely.
- Track changes with precision. You can read specific details for a single record using `get_entry`, or make targeted adjustments via `update_entry` without affecting other submissions.
- Scale your automation by chaining this MCP with others. For instance, passing data collected from the forms into an accounting system MCP to trigger billing.
- Gain full visibility into form assets by running `list_forms` and getting a complete inventory of every active project in one command.

## How It Works

The bottom line is you use your AI agent as a conversational wrapper around complex form data management.

1. Subscribe to this MCP and get your API Token from Cognito Forms settings.
2. Connect the token to any compatible AI client (Claude, Cursor, etc.) via Vinkius.
3. Ask your agent to perform an action, like 'List all sales forms' or 'Create a new feedback entry'.

## Frequently Asked Questions

**How do I list all my active forms using the Cognito Forms MCP?**
Run `list_forms`. This returns a comprehensive list of every project available in your account, allowing you to see which ones are currently accepting submissions.

**Can I update an entry without knowing its ID?**
No. You must first use `get_entry` or `search_entries` to find the specific record and retrieve its unique ID, then pass that ID into the `update_entry` tool.

**What if I need to see what fields are available for a form?**
Use `get_form_fields`. This pulls the full JSON schema definition. It's the only way to programmatically confirm every field name and its data type.

**Is there a tool to create records in Cognito Forms?**
Yes, use `create_entry`. Your agent can take input from you or another MCP and submit it as a brand new record instantly.

**How do I remove a submission using the `delete_entry` tool?**
You must provide the specific entry ID to delete it. The agent sends a deletion request, and if successful, the record is immediately removed from Cognito Forms. This is useful for correcting erroneous or sensitive data.

**If I need to find submissions based on criteria like user name or date, should I use `search_entries`?**
Yes, using `search_entries` lets you filter entries across specific parameters. This is much more powerful than listing all entries because it targets data within a defined scope.

**What kind of metadata can I retrieve about available forms using `list_templates`?**
The tool returns details on your form blueprints and templates. You'll get names, IDs, and status information for all the underlying structures you use to build new content.

**How do I confirm that my MCP connection is working correctly using `check_cognito_status`?**
Running `check_cognito_status` confirms connectivity with Cognito Forms. A successful response means your agent has the necessary permissions and can communicate with your form account.