Formbridge

What is FormBridge?

FormBridge is a mixed-mode agent-human form submission infrastructure. It enables AI agents to fill known form fields while humans complete the rest, with full field-level attribution, approval workflows, and webhook delivery.

How to use FormBridge?

Install @formbridge/mcp-server via npm. Then run it as an HTTP API server using createFormBridgeApp, as an MCP server using FormBridgeMCPServer (connected via stdio), or scaffold a project with npx @formbridge/create. Optionally embed React forms using @formbridge/form-renderer and manage submissions with the admin dashboard.

Key features of FormBridge

• Mixed-mode agent-human form filling with field-level attribution
• Secure resume tokens for human handoff URLs
• Configurable approval gates and webhook delivery (HMAC‑signed)
• MCP server auto‑generates tools from intake definitions
• Pluggable storage: in‑memory, SQLite, PostgreSQL, S3
• Schema normalization: accepts Zod, JSON Schema, or OpenAPI specs

Use cases of FormBridge

• Vendor onboarding — agents fill company details, human uploads W‑9
• IT access requests — agent provisions basic info, human approves
• Customer intake — agent collects contact data, human adds preferences
• Expense reports — agent extracts receipt data, human verifies
• Bug reports — agent captures system info, human describes behavior

FAQ from FormBridge

What are the runtime dependencies?

Node.js 18 or later. For SQLite storage, the SQLite module is required; for PostgreSQL, a pg client is needed. The form‑renderer requires React 18+.

What transport protocols does FormBridge support?

It supports HTTP (REST API), MCP (stdio transport for AI agents), and CLI scaffolding via npx @formbridge/create. The MCP server auto‑generates four tools per intake: create, set, validate, submit.

How is data stored and secured?

Storage backends are pluggable (in‑memory, SQLite, PostgreSQL, S3 for file uploads). Submissions use idempotency keys to prevent duplicates. Auth options include API keys, OAuth, and role‑based access control. Webhook payloads are HMAC‑signed.

Does FormBridge support file uploads?

Yes, via a signed URL protocol for secure file handling. The README details endpoints for requesting upload URLs and verifying uploads, compatible with S3.

Can I run FormBridge without a database for development?

Yes. Use the in‑memory storage backend (default) for development. For production, SQLite (single‑server) or PostgreSQL (multi‑replica HA) are available.