Formdesk MCP server
39 operations0 webhooks
Connect to Formdesk REST v1 to manage forms, submissions, users, visitors, and uploaded files with validated requests and responses.
Try Formdesk with your agent
Connect Formdesk, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in Formdesk on my account, then run one read-only example and show me the result.
Formdesk tools and triggers
Tools are what your agent can do in Formdesk through Corsair's MCP server. Triggers are the Formdesk events a routine can start from.
Results
- AddWrite
Add up to 10 form results (1 API credit per call)
results.add
- All FilesRead-only
List files attached to a form’s results (1 API credit per call)
results.allFiles
- Delete All FilesDestructive
Delete all files attached to a form’s results (1 API credit per call)
results.deleteAllFiles
- Delete FilesDestructive
Delete files attached to a result (1 API credit per call)
results.deleteFiles
- ExportRead-only
Export form results; credits equal completed forms downloaded
results.export
- FilesRead-only
List files attached to a result (1 API credit per call)
results.files
- GetRead-only
Retrieve a form result (1 API credit per call)
results.get
- IncrementWrite
Atomically increment a numeric field (1 API credit per call)
results.increment
- ListRead-only
List form result IDs (1 API credit per call)
results.list
- Mark ProcessedWrite
Mark a result processed for synchronization (no credit charge)
results.markProcessed
- PdfRead-only
Generate a completed-form PDF (1 API credit per call)
results.pdf
- RemoveDestructive
Remove a form result; deleted entries may remain retrievable for 30 days (1 API credit per call)
results.remove
- UpdateWrite
Update a form result (1 API credit per call)
results.update
- WorkflowsRead-only
List result workflows (1 API credit per call)
results.workflows
Visitors
- AddWrite
Create a form visitor (1 API credit per call)
visitors.add
- GetRead-only
Retrieve a visitor by ID (1 API credit per call)
visitors.get
- Get ExternalRead-only
Retrieve an external visitor by provider ID (1 API credit per call)
visitors.getExternal
- ListRead-only
List form visitors (1 API credit per call)
visitors.list
- RemoveDestructive
Permanently remove a form visitor (1 API credit per call)
visitors.remove
- ResultsRead-only
List a visitor’s form result IDs (1 API credit per call)
visitors.results
- Sign OnWrite
Create a visitor single sign-on link (1 API credit per call)
visitors.signOn
- UpdateWrite
Update a form visitor (1 API credit per call)
visitors.update
Users
- AddWrite
Create a Formdesk user (1 API credit per call)
users.add
- GetRead-only
Retrieve a user by ID (1 API credit per call)
users.get
- Get ExternalRead-only
Retrieve an external user by provider ID (1 API credit per call)
users.getExternal
- ListRead-only
List Formdesk users (1 API credit per call)
users.list
- RemoveDestructive
Permanently remove a Formdesk user (1 API credit per call)
users.remove
- Sign OnWrite
Create a user single sign-on link (1 API credit per call)
users.signOn
- UpdateWrite
Update a Formdesk user (1 API credit per call)
users.update
Files
- ContentRead-only
Download file content (1 API credit per call)
files.content
- GetRead-only
Retrieve file metadata (1 API credit per call)
files.get
- ListRead-only
List account and result files (1 API credit per call)
files.list
- RemoveDestructive
Permanently remove a file (1 API credit per call)
files.remove
Forms
- FiltersRead-only
List saved filter names (1 API credit per call)
forms.filters
- ItemsRead-only
List input items on a form (1 API credit per call)
forms.items
- ListRead-only
List forms (1 API credit per call)
forms.list
- ParkWrite
Create a prefill parking ticket (1 API credit per call)
forms.park
Connect
- Api KeyRead-only
Resolve the tenant host using the stored API key (Connect is free)
connect.apiKey
- CredentialsRead-only
Resolve the tenant host and API key from Formdesk credentials (free)
connect.credentials
Connect Formdesk to Claude, ChatGPT or Cursor
- 1
Connect Formdesk in Corsair
Add your Formdesk API key once in Corsair. Corsair stores the credential encrypted and makes the Formdesk API calls for your agent, so it never goes into a prompt or a config file. Connect Formdesk
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs Formdesk. On a ChatGPT personal plan, connect Formdesk here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, Formdesk's read and write operations run right away and its 6 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/formdesk, add the Formdesk plugin, and connect with an API key. Then call methods like corsair.formdesk.api.connect.apiKey() from your app. Corsair keeps each tenant isolated.
Yes. Formdesk requires an API key from your Formdesk account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit Formdesk, GitHub, Notion, Stripe, and the rest. Trigger Formdesk from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for connect to Formdesk REST v1 to manage forms, submissions, users, visitors, and uploaded files with validated requests and responses. Common builds include sync jobs, admin tooling, and agents that call Formdesk APIs from your backend.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per Formdesk API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/formdesk in the open repo. When Formdesk ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your Formdesk data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store Formdesk data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put Formdesk on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 6 destructive Formdesk operations. You can change a link's mode at hub.corsair.dev/me.