FormLMVerifiedFeatured

What is formlm-cli?

formlm-cli is the official CLI & MCP Server for FormLM, an AI-powered form and assessment platform. It exposes 6 tools and 6 knowledge resources to any MCP-compatible AI agent — letting you build scoring quizzes, configure dimensions, generate reports, and publish forms entirely through natural language, no UI required.

How to use formlm-cli?

Install globally via npm, start the MCP Server, and connect it to your AI agent (Claude Desktop, Cursor, Codex CLI, Windsurf, Cline, etc.). Authenticate with your FormLM token, then describe what you want in plain English — the smart pipeline handles form design, scale configuration, report layout, and visual styling automatically.

Key features of formlm-cli

• Smart Pipeline — formlm_generate wraps the full AssessAgent pipeline (plan → execute → reflect) to produce complete apps from a single prompt
• 6 Layered Tools — auth, generate, snapshot, skill, and exec across 4 tiers of control
• 6 Knowledge Resources — domain-specific SKILL.md files exposed as MCP resources so AI agents see P0 constraints natively
• State Awareness — formlm_snapshot returns all module states in one call for precise, context-aware operations
• Universal Compatibility — works with any MCP client, not tied to a specific platform
• Full Lifecycle — create → score → style → report → publish, all in conversation

Use cases of formlm-cli

• Generate a workplace stress assessment with dimensions, scoring, and interpretation in one prompt
• Build a personality quiz with weighted scoring and a visual report page
• Create a consultation intake form and style it with a custom theme
• Publish a form and get a shareable link without opening a browser

FAQ from formlm-cli

Which AI platforms are supported?

Any MCP-compatible client: Claude Desktop, Cursor, Codex CLI, Windsurf, Cline, and others.

Do I need a FormLM account?

Yes. Run auth_login with your email and password, or provide a token directly.

What does the smart pipeline do?

It takes a natural language description and orchestrates the full server-side AssessAgent — form design, scale setup, report generation, and visual styling — returning a ready-to-use app.

Can I control individual modules?

Yes. Use formlm_exec to run any whitelisted CLI command for fine-grained control over fields, scales, pages, widgets, and sharing.