Skip to main content
Glama

FormFor MCP Server

Remote MCP (Model Context Protocol) server for FormFor. Runs on Cloudflare Workers as a McpAgent Durable Object with SSE transport. Lets any MCP-compatible AI client create forms, collect data, and check responses.

Quick Start

Connect any MCP client to:

https://mcp.formfor.ai/sse

With header:

Authorization: Bearer ff_live_...

Related MCP server: Homespun

Tools

Tool

Description

formfor_ask

Ask a human a yes/no question. Sends an email, returns { approved: true/false }.

formfor_collect

Collect structured data via a multi-field form. Supports 14 field types.

formfor_check

Check if a form has been completed and retrieve the response data.

formfor_list

List recent forms with optional status filter.

formfor_ask

{
  "question": "Deploy to production?",
  "to": "ops@company.com",
  "context": "All tests passing on staging",
  "expires": "4h"
}

formfor_collect

{
  "title": "Bug Report Triage",
  "to": "eng@company.com",
  "fields": [
    { "id": "severity", "type": "select", "label": "Severity", "options": ["P0", "P1", "P2"] },
    { "id": "description", "type": "textarea", "label": "Description", "required": true }
  ],
  "expires": "24h"
}

formfor_check

{
  "form_id": "form_abc123"
}

formfor_list

{
  "status": "pending",
  "limit": 10
}

Architecture

MCP Client --> SSE (/sse) --> FormForMCP (McpAgent Durable Object)
                                    |
                                    +-- API (service binding) -- form CRUD
                                    +-- Agents (service binding) -- agent state
                                    +-- D1 -- API key auth

Auth Flow

  1. MCP client connects to /sse with Authorization: Bearer ff_live_...

  2. Worker authenticates the API key against D1 (SHA-256 hash lookup)

  3. Auth header is captured in onConnect and forwarded to API service binding on every tool call

Transport

SSE (Server-Sent Events) via the Agents SDK McpAgent.serveSSE(). CORS is configured for cross-origin access.

Development

npm install
npm run dev

Deployment

npm run deploy

Environment Variables

Bindings

Binding

Type

Description

MCP_AGENT

Durable Object

FormForMCP class

DB

D1

API key authentication

API

Service

formfor-api worker

AGENTS

Service

formfor-agents worker

License

MIT

Related MCP Connectors

Related MCP Servers