⌨️

Developer Zone

Build with FormLM in code: a form Data API that stores submissions from any static page or AI app, and an open-source CLI + MCP server that lets AI agents build and manage your forms.

🔌 Data API
⌨️ formlm-cli
🤖 MCP Server
🔓 Open Source (MIT)

🧰 The Developer Toolkit

2 Core Tools
🔌

Data API — a form backend over HTTP

Publish any FormLM form and get an endpoint that accepts JSON or native HTML form POSTs. CORS is fully enabled, unknown fields can auto-create their own columns, and every endpoint documents itself in Markdown at ?help — readable by humans and AI agents alike.

⌨️

formlm-cli — terminal + MCP server

An MIT-licensed npm package that controls FormLM from the terminal: generate complete assessment apps from natural language, manage fields, scales, reports, and publishing. Run formlm-cli mcp and it becomes an MCP server any AI agent can plug into.

The Data API: POST data, get storage

One endpoint, two formats, zero servers to run.

Every published form exposes a Data API endpoint. POST JSON to it and each request becomes a stored, queryable record — with a data-management UI, CSV export, and aggregate statistics for free. It works from static sites, local HTML files, scripts, IoT devices, and AI-generated pages, because CORS is enabled on both reads and writes.

Data API operation demo
Data API in action — publish, POST, and query back
# Write a record from anywhere — curl, fetch, or an AI agent
curl -X POST https://formlm.me/api/v3/share/<your-token> \
  -H "Content-Type: application/json" \
  -d '{"data":{"name":"Ada","score":92}}'

# Read it back — paginated JSON, up to 1000 records per page
curl "https://formlm.me/api/v3/share/<your-token>/query?page=1&size=20"

# The endpoint documents itself in Markdown — for you or your agent
curl "https://formlm.me/api/v3/share/<your-token>?help"
EndpointMethodWhat it does
/{token}POSTStore a record — JSON body, canonical shape {"data":{...},"meta":{...}} or flat objects
/{token}/formPOSTStore a native HTML form submission (application/x-www-form-urlencoded)
/{token}?helpGETReturn the endpoint's own Markdown API documentation — readable by AI agents
/{token}/queryGETPage through stored records as JSON
/{token}/summaryGETAggregate statistics over the collected records

Proof it holds up in production: the feedback form on FormLM's own contact page is a static form that POSTs straight to a Data API endpoint — the exact pattern documented above, running on our marketing site today.

Dive deeper into the use case that matches your stack:

formlm-cli: the terminal is a first-class client

npm package, MIT license, Node.js ≥ 18.

Install it, log in once — copy the Access Token from formlm.me → Account Settings (no password needed), or use the in-terminal email verification-code login — and the whole platform becomes scriptable. The highlight is smart generate: one natural-language instruction runs the server-side agent pipeline and produces a complete assessment app — form design, scoring dimensions, report pages, and visual styling included.

# Install and generate a full assessment app from one sentence
npm install -g @formlm/cli

formlm-cli auth login --token <your-token>
# token: formlm.me → Account Settings → Access Token → Copy
# no token? run: formlm-cli auth login  → choose the email verification-code option

# Form + scales + report + styling, all in one command (60–300s)
formlm-cli smart generate \
  --input "Create a workplace stress assessment with 10 questions, 3 dimensions, and detailed score interpretations"

# Get the fill-in, editor, and data-management URLs
formlm-cli app urls --app <appId>

# Publish it
formlm-cli share publish --app <appId>

For fine-grained control there are 50+ commands across eight modules: app, field, scale, connect (page styling), report, expert, share, and profile — plus snapshot to dump all module states as JSON or Markdown, and skill to print the domain rule documents that keep generated content well-formed, and doctor to audit a finished app read-only (publish access, dead experts, report coverage, language consistency).

MCP server: let AI agents drive FormLM

stdio transport · 10 tools · 6 resources · works with any MCP client.

Run formlm-cli mcp and the CLI becomes a standard MCP server. Connect Claude Desktop, Cursor, Codex CLI, Windsurf, Cline or WorkBuddy — or any MCP-compatible client — and the agent can build, inspect, and publish your forms conversationally, with the platform's P0 constraints embedded in every tool description so it doesn't drift.

# The official install form — stdio, one command, drops into any MCP client
npx -y @formlm/cli mcp

# client config form (Claude Desktop / Cursor / Codex CLI / Windsurf / Cline / WorkBuddy):
# {"mcpServers":{"formlm":{"command":"npx","args":["-y","@formlm/cli","mcp"]}}}
# optional env FORMLM_TOKEN = Access Token (formlm.me → Account Settings → Access Token → Copy)
ToolTierWhat the agent can do
auth_login / auth_email_code / auth_status0Authenticate with an Access Token (recommended), email verification code, or email + password
formlm_usage0Read the account budget before batch work: plan, app slots (free plan caps at 10; recycle-bin apps still hold a slot) and AI credits
formlm_generate1Generate the execution plan from natural language (AssessAgent pipeline)
formlm_execute1Run the planned modules one by one (form → scale → connect → report → expert → share)
formlm_doctor2Audit an app read-only: publish access, dead experts, report coverage, language consistency
formlm_snapshot2Read the aggregated state of every module in one call
formlm_skill2Fetch the SKILL.md domain rules for any module
formlm_exec3Run any whitelisted CLI command directly

Six MCP resources (formlm://skills/form, scale, connect, report, expert, share) expose the same domain knowledge the platform's own agents use — so your AI reads the rules before it writes the config. Full setup instructions, including the PATH fix for macOS desktop clients and per-platform config locations, live in the INSTALL guide on GitHub.

📖 Guides & Documentation

18 Published
🧩 Framework Guide
Forms in Next.js, Astro, and Hugo — Without Writing a Backend
Put working forms in Next.js client components, Astro islands, or Hugo pages—one hosted endpoint stores every submission. No API routes, no server.
📖 11 min read Read More →
🤖 MCP Workflow
Build a Complete Assessment in Claude Desktop: The MCP Walkthrough
Install formlm-cli as an MCP server, then generate, review, and publish a full assessment app—form, scales, report, styling—entirely inside Claude Desktop.
📖 10 min read Read More →
🔄 Data Pipelines
Your Form Data, Programmable: Query, Summary, and CSV Workflows
Page through every submission over HTTP, read aggregates instead of raw rows, export CSV, and pipe form data into dashboards and AI agent context.
📖 10 min read Read More →
🌐 Static Hosting
Add a Contact Form to GitHub Pages, Netlify, or Vercel — Without a Backend
Give any static site on GitHub Pages, Netlify, or Vercel a working contact form—one action URL, no server, no database, free.
📖 8 min read Read More →
🤖 AI Workflows
Form Backend for AI-Generated Websites: Claude, Cursor, Bolt—and Pages That Can't Collect Anything
AI-generated landing pages ship with dead forms. One action URL—or one line in the prompt—makes them collect submissions into a real inbox.
📖 9 min read Read More →
🤖 AI Workflows
Coding-Agent Form Backend: Give Claude Code & Cursor Real Data Collection
Give Claude Code, Codex or Cursor a real form backend: one ?help endpoint the agent reads, one npx @formlm/cli command it runs.
📖 9 min read Read More →
🔌 API Overview
FormLM Data API — Free Form Backend for Static Sites
Give any static site, local page, or AI app a data layer in 60 seconds. One URL accepts JSON or HTML form POST and stores every submission — no server required.
📖 Doc Read More →
🤖 For AI Agents
FormLM Data API for AI Agents: Agent-Readable Data Storage
Agents build pages in minutes — then lose the data. FormLM's self-documenting Data API lets Claude, ChatGPT, and coding agents integrate storage on their own.
📖 Doc Read More →
🌐 Static Sites
Add a Form to Your Static Site Without a Backend
Collect submissions from a static site with no backend: point your HTML form at a FormLM endpoint. Works on GitHub Pages, Netlify, and any static host.
📖 Doc Read More →
📮 Contact Forms
Free Contact Form Backend for Static Websites
A working contact form for your site in minutes — free. Point the action at a FormLM endpoint; submissions are stored and queryable. No server, no JavaScript.
📖 Doc Read More →
📄 Plain HTML
HTML Form POST Without a Server or JavaScript
A plain HTML form can store its submissions: point the action at a FormLM endpoint and POST natively. No server, no JavaScript, no build step.
📖 Doc Read More →
🧱 JSON Storage
JSON API to Store Data: No Server, No Database
POST JSON to a URL and it's stored — that's the whole API. A free data endpoint for scripts, automations, IoT, and AI apps, with records queryable over HTTP.
📖 Doc Read More →
💾 Local Pages
Save Data From a Local HTML Page or AI App
A local HTML file — opened from disk or generated by AI — can save data to the cloud. FormLM's CORS-enabled API accepts POSTs from file:// pages, no deploy.
📖 Doc Read More →
🛠 Claude
Claude + FormLM Data API: MCP Data Storage Setup
Let Claude store and query data — over MCP or a plain URL. One endpoint, self-documenting at ?help, so Claude reads the docs itself. Free, five-minute setup.
📖 Doc Read More →
🛠 Cursor
Cursor + FormLM Data API: MCP Storage Setup
Cursor agents write trackers and forms that lose data on refresh. Add a FormLM endpoint in .cursor/mcp.json — or just paste the ?help URL in chat.
📖 Doc Read More →
🛠 Codex CLI
Codex CLI + FormLM Data API: Agent Data Storage
Codex CLI writes the code, but sandbox files don't survive. Give Codex a FormLM endpoint — it reads the ?help docs itself, or connect formlm-cli in config.toml.
📖 Doc Read More →
🛠 Windsurf
Windsurf + FormLM Data API: MCP Storage Setup
Windsurf's Cascade builds tools in minutes — then the data vanishes. Connect a FormLM MCP server in mcp_config.json, or hand Cascade a self-documenting URL.
📖 Doc Read More →
🛠 Cline
Cline + FormLM Data API: MCP Storage for VS Code
Cline plans, codes, and executes in VS Code — but outputs die with the workspace. Add formlm-cli to cline_mcp_settings.json and every task persists its results.
📖 Doc Read More →
🛠 WorkBuddy
WorkBuddy + FormLM Data API: Save Agent Output
WorkBuddy automates research and documents — then results sit in chat. Give it a FormLM endpoint URL and every task outcome becomes a stored, queryable record.
📖 Doc Read More →
🗺️ Developer Quick Start Path
1
Create and publish a form
Build one in the web UI, or generate it with formlm-cli smart generate, then publish it.
2
Grab the Data API endpoint
Open the publish page and copy the endpoint URL. Append ?help to read its self-documentation.
3
POST from your page, script, or agent
Point a form action or fetch call at the endpoint — CORS is open, unknown fields auto-create columns.
4
Query, export, or automate at scale
Read records back over HTTP, export CSV from the data UI, or wire the whole lifecycle into scripts with formlm-cli.

Developer FAQ

The questions we get from builders.

What developer tools does FormLM provide?

Two core tools. The Data API is an HTTP endpoint that stores submissions from any page — static sites, local files, or AI-generated apps — and lets you query the records back. formlm-cli is an open-source command-line tool and MCP server that lets you or an AI agent build and manage forms from the terminal.

How do I let my AI agent use FormLM?

Two ways. Read/write data: give your agent a Data API endpoint — it can read the endpoint's own documentation by appending ?help to the URL, then POST records directly. Build and manage forms: install formlm-cli and run `formlm-cli mcp`, then connect any MCP-compatible client such as Claude Desktop, Cursor, Codex CLI, Windsurf, Cline, or WorkBuddy.

Is the Data API free to use?

Yes. Publishing a form and receiving submissions through the Data API is available on the free plan; paid plans add higher volumes and team features. There is no charge per API call on the free tier.

Is formlm-cli open source?

Yes — formlm-cli is MIT-licensed and published on npm as @formlm/cli. The source lives on GitHub at github.com/formlm/cli, and it works with any FormLM account, free or paid.

What can an AI agent do through the MCP server?

The MCP server exposes ten tools: auth_login, auth_email_code and auth_status for authentication, formlm_usage to read your plan, app-slot usage and AI credits before batch work, formlm_generate to plan an assessment app from natural language, formlm_execute to run each plan module, formlm_doctor to audit an app read-only, formlm_snapshot to read all module states, formlm_skill to fetch domain rule documents, and formlm_exec to run any whitelisted CLI command. Six MCP resources also expose the skill documents directly to the agent.

Can I use the Data API with my own HTML page?

Yes. Publish a form in FormLM, copy its Data API endpoint, and point your page at it — either a native HTML form action POST or a fetch call. CORS is enabled, so it works from static hosts and even from files opened directly off disk.

← Back to Academy Home Explore the Data API →