FormHug MCP Server

Connect Claude, Cursor, or any MCP-compatible AI assistant to FormHug and manage forms and submissions through natural language.

The FormHug MCP Server lets AI assistants manage your forms and data through natural language. Built on the open Model Context Protocol, it turns any MCP-compatible client into a full FormHug interface — create forms, edit fields, read submissions, and submit entries without opening the dashboard.

Create Forms

Describe what you need — AI generates fields and creates the form instantly

Edit Forms

Add or remove fields, update names and descriptions

Read Submissions

Browse, search, and retrieve form entries

Submit Entries

Post new entries to any form programmatically

MCP server details

Property	Value
URL	https://formhug.ai/mcp
Transport	Streamable HTTP
Auth	OAuth 2.1 (authorization code + PKCE)

Prerequisites

• A FormHug account — sign up at formhug.ai
• An MCP-compatible agent or IDE
• A web browser for the OAuth login flow

Why do I need a FormHug account? FormHug uses OAuth 2.1 to authenticate your agent. This links the agent’s actions to your identity, so you control what it creates and submits on your behalf. Without authentication, the agent cannot access any FormHug tools, including filling other people’s forms.

Agent Capabilities

FormHug is built for both human users and AI agents. Forms stay easy for people to fill out, while remaining structured and machine-readable for MCP-compatible tools.

With the FormHug MCP server, an authenticated agent can manage forms in your account and submit entries to any published FormHug form.

Manage your own forms

If you have a FormHug account, your agent can create forms, update fields, read submissions, and delete forms on your behalf.

Example:

“Create a job application form with fields for name, email, LinkedIn URL, years of experience, and a cover letter”

Your agent can build the form and return a shareable link without needing you to open the dashboard.

Submit to any published form

Authenticated agents can also submit entries to published FormHug forms they do not own. Form creators do not need to configure anything extra.

Example:

“Fill in the onboarding form at formhug.ai/f/abc123 using the details from my notes”

Connect Your Client

Claude Desktop

1. Open Config

   Open Claude Desktop → Settings → Developer → Edit Config.

2. Add FormHug

   Add FormHug under mcpServers:

   {
     "mcpServers": {
       "formhug": {
         "type": "http",
         "url": "https://formhug.ai/mcp"
       }
     }
   }
   
3. Restart and Sign In

   Restart Claude Desktop and sign in when prompted.

Cursor

1. Open MCP Settings

   Open Cursor → Settings → MCP Servers → Add Server.

2. Enter Server URL

   Paste the server URL: https://formhug.ai/mcp

3. Authorize

   Authorize when prompted.

Other MCP Clients

Any client that supports the Model Context Protocol can connect using the server URL above. The server uses standard HTTP transport.

Available Tools

Tool	What It Does
list_forms	List your forms, with optional name filter
get_form	Get form details including all field definitions and api_codes
preview_form	Get a readable summary of a form’s structure
create_form	Create a new form, optionally with fields defined at the same time
update_form	Update a form’s name or description
delete_form	Permanently delete a form and all its data
add_fields	Append new fields to an existing form
remove_field	Remove a field by its api_code
list_entries	Page through a form’s submissions
get_entry	Retrieve a single entry by serial number
submit_entry	Submit a new entry to a form

delete_form permanently deletes the form and all its submissions. This action cannot be undone.

Supported Field Types

When using submit_entry, call get_form first to get each field’s api_code. Then pass values keyed by api_code:

Field Type	Value Format
TextField, TextArea, EmailField, MobileField	String
NumberField	Number
RadioButton, DropDown	Choice api_code string
CheckBox	Array of choice api_code strings
DateTimeField	ISO 8601 datetime string
RatingField	Integer (1 to rating_max; rating_max is 3–10)
NpsField	Integer (0–10)

The same field types are available when creating forms or adding fields with create_form and add_fields:

TextField · TextArea · EmailField · MobileField · NumberField · RadioButton · CheckBox · DropDown · DateTimeField · RatingField · NpsField · LinkField · AttachmentField

Example Prompts

Once connected, give your AI assistant natural language instructions:

Building and editing forms

• “Create a customer feedback form with a star rating, email, and comment field”
• “Add a required phone number field to my Event Registration form”
• “Show me all my forms”
• “What fields does my Contact Us form have?”

Reading submissions

• “List the last 20 submissions for my Contact Us form”
• “Show me the most recent entry on my survey”
• “Get entry number 5 from my registration form”

Managing forms

• “Rename the form called Test to Customer Feedback 2025”
• “Delete the form called Old Test Form”

Submitting entries

• “Submit a test entry to my Contact form — name: Jane Smith, email: [e-mail]”

Related

Form Submissions

View and manage submissions in the FormHug dashboard

AI Form Builder

Build forms with AI directly inside FormHug

Form Builder

Learn how fields and forms are structured

Contact Support

Questions about the MCP server? Email [e-mail]