Formly for developers & agents

Build and run forms with AI agents

Formly speaks MCP and has a simple REST API. Connect your favorite AI agent and let it create, edit, and publish forms, no clicking required.

Get an API key Quickstart

Quickstart

Three steps to your first agent-built form

Create an API key

In Formly, go to Settings → Developer and generate a key. Pro plan required.

Connect your agent

Add Formly's MCP server (hosted URL or local npx) to Claude, Cursor, Codex, and more.

Just ask

Say "build a contact form and publish it" and your agent does the rest.

MCP

Connect your agent

Formly is a Model Context Protocol (MCP) server. Use the hosted endpoint, or run it locally with npx.

Fastest: let your agent install it

Create an API key, paste it into the prompt, then drop the whole thing into a coding agent (Codex, Claude Code, Cursor). It registers the MCP server and connects itself, no manual config.

Set up the Formly MCP server on this machine so you can build and manage my forms, then use it.

1. Register an MCP server named "formly" using whichever method fits your client:
   - Codex CLI:   codex mcp add formly --env FORMLY_API_KEY=formly_sk_your_key_here -- npx -y formly-mcp
   - Claude Code: claude mcp add formly --env FORMLY_API_KEY=formly_sk_your_key_here -- npx -y formly-mcp
   - Cursor / Claude Desktop / other: add this stdio server to your MCP config JSON (e.g. ~/.cursor/mcp.json):
     "formly": { "command": "npx", "args": ["-y", "formly-mcp"], "env": { "FORMLY_API_KEY": "formly_sk_your_key_here" } }
2. Reload or restart your MCP servers so the "formly" tools load.
3. Verify by calling list_forms, then tell me what forms I have.

Once connected, the tools are: create_form, edit_form, update_form_settings, publish_form, unpublish_form, list_forms, get_form, get_submissions, list_spaces. When I describe a form in plain language, create it and reply with the edit + public links. Only publish when I say so.

Or wire it up manually:

Remote (hosted)

Add a remote MCP server with this URL and your API key as a bearer token. Zero install.

URL:    https://api.formly.so/mcp
Header: Authorization: Bearer YOUR_API_KEY

Local (npx)

Drop this into your agent's MCP config (Cursor, Claude Desktop, Codex, and others).

{
  "mcpServers": {
    "formly": {
      "command": "npx",
      "args": ["-y", "formly-mcp"],
      "env": {
        "FORMLY_API_KEY": "formly_sk_your_key_here"
      }
    }
  }
}

Codex CLI

codex mcp add formly \
  --env FORMLY_API_KEY=formly_sk_your_key_here \
  -- npx -y formly-mcp

Tools your agent gets:

list_spaceslist_formsget_formcreate_formedit_formupdate_form_settingspublish_formunpublish_formget_submissions

REST API

Or call the API directly

Every endpoint is authenticated with your API key via the Authorization header. Base URL: api.formly.so

curl -X POST https://api.formly.so/v1/forms/ai \
  -H "Authorization: Bearer $FORMLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"description":"a customer feedback survey","publish":true}'

POST/v1/forms/ai

Create a form from a description (AI)

POST/v1/forms/{id}/ai

Edit a form with an instruction (AI)

GET/v1/forms

List your forms

GET/v1/forms/{id}

Get a form's full structure

POST/v1/forms

Create a blank or structured form

PUT/v1/forms/{id}

Update a form's name or pages

PATCH/v1/forms/{id}/settings

Update a form's settings

POST/v1/forms/{id}/publish

Publish a form

POST/v1/forms/{id}/unpublish

Unpublish a form

DELETE/v1/forms/{id}

Delete a form

GET/v1/forms/{id}/submissions

List responses

GET/v1/spaces

List workspaces

Examples

Things to ask your agent

“Build a job application form with name, email, and a resume upload, then publish it.”

“Add a 1–5 rating question to my customer feedback form.”

“Make the email field on my contact form required.”

“Show me the 10 most recent responses to my signup form.”

Ready to go agentic?

Create an API key and connect your agent in under two minutes.

Get your API key