- Docs
- AI agents
MCP server for form submissions (coming soon)
Not available yet. The MCP server is in development; nothing on this page works today. It describes the planned interface so you can see where FormRill is going. Tool names, arguments and setup may change before launch.
FormRill will expose your form submissions over the Model Context Protocol, so AI agents can read and triage your contact form inbox directly, from the editor or chat you already work in.
Planned tools
| Tool | What it will do |
|---|---|
list_submissions | Latest submissions. Arguments: limit, unread_only. |
search_submissions | Full-text search. Arguments: query, date_range. |
mark_read | Mark a submission as read. Argument: id. |
Planned setup
1. Create an MCP token
You’ll create a dedicated token for agents in the dashboard. Like your dashboard login, and unlike your public form URL, it will be able to read submissions, so keep it private.
2. Connect your agent
The server will speak MCP over HTTP at https://mcp.formrill.com/mcp.
Claude Code connects to remote HTTP servers directly:
claude mcp add --transport http formrill https://mcp.formrill.com/mcp \
--header "Authorization: Bearer YOUR_MCP_TOKEN"Cursor takes the URL and header in its MCP config:
{
"mcpServers": {
"formrill": {
"url": "https://mcp.formrill.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_MCP_TOKEN"
}
}
}
}Claude Desktop starts local commands from its config file, so it reaches a remote server through a small bridge such as mcp-remote (needs Node.js):
{
"mcpServers": {
"formrill": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.formrill.com/mcp",
"--header",
"Authorization: Bearer YOUR_MCP_TOKEN"
]
}
}
}3. Ask
- “Any new contact form leads today?”
- “Find submissions that mention a budget and draft replies.”
- “Summarise this week’s enquiries by topic.”
What you can do today
Agents can already act on submissions as they arrive: add a webhook or n8n automation and FormRill posts every submission as JSON to your workflow. To hear when MCP ships, email hello@formrill.com.
Start collecting submissions today
Free up to 500 submissions a month and unlimited forms. No server, no credit card.
Start freeRelated
- Submission API reference
Including the webhook payload.
- Changelog
What’s live and what’s next.