AI Agent Integration

Connect Cursor, Claude Desktop, or your own scripts to EzyForm. AI agents can create forms, publish drafts, read submissions, and more — all programmatically via API keys and MCP.

AI Form Builder vs AI Agent Integration

What agents can do

• Create blank forms and update draft field configurations
• Publish drafts and reset drafts to the last published version
• List, read, and delete submissions
• Toggle submission listed/unlisted status
• Create refill links for respondents
• Duplicate, close, and reopen forms (REST only for some operations)

What agents cannot do

• Upload files on behalf of respondents (FILE_UPLOAD fields can be defined; uploads happen on the public form)
• Edit forms in the visual UI — agents work via structured JSON
• Bypass plan limits (e.g. Free plan caps at 5 forms)

Quick start

1. Sign up at ezyform.app (or log in if you already have an account).
2. Go to Account → API Keys and click Create key. Give it a name (e.g. "Cursor agent"). Copy the key — it is shown only once.
3. Add this to your MCP client config (Cursor, Claude Desktop, etc.):

{
  "mcpServers": {
    "ezyform": {
      "command": "npx",
      "args": ["-y", "@ezyform/mcp"],
      "env": {
        "EZYFORM_API_URL": "https://ezyform.app",
        "EZYFORM_API_KEY": "ezyform_live_..."
      }
    }
  }
}

Replace ezyform_live_... with your actual key. Restart your MCP client after saving.

Signed-in users can manage keys at Account → API Keys.

Supported clients

• Cursor — add the JSON block above to your MCP settings
• Claude Desktop — same config in claude_desktop_config.json
• Any MCP client — stdio transport via npx -y @ezyform/mcp
• Custom scripts — call the REST API directly with Authorization: Bearer ezyform_live_...

Agent workflow

1. Create form — ezyform_create_form with optional title (blank form).
2. Update draft — ezyform_update_form_draft with full FormConfig JSON (fields, startProp, endProp).
3. Validate — Backend validates via Zod; fix errors from response details and retry.
4. Publish — ezyform_publish_form when draft is ready. Returns no_change if hash unchanged.
5. List responses — ezyform_list_submissions with filter listed, unlisted, or all.
6. Refill link — ezyform_create_refill_link for a submission (creates a URL; does not fill the form).

MCP resources ezyform://schema/fields, ezyform://docs/workflow, and ezyform://docs/errors provide full reference when connected.

Plan limits

Call GET /api/v1/agent/me (or MCP tool ezyform_get_me) to read your current plan and limits.

Security

• API keys are shown only once at creation. Store them securely.
• You can create up to 10 active keys per account.
• Revoke a key anytime from Account → API Keys. Agents using it stop working immediately.
• Keys are scoped to your account — agents can only access your forms and submissions.

Troubleshooting

REST API reference

All endpoints require Authorization: Bearer ezyform_live_... and return JSON.

Base URL: https://ezyform.app/api/v1/agent

Need help?

Email hello@ezyform.app or see the FAQ.