Home/Docs/MCP Server

MCP Server

Form Dump exposes a Model Context Protocol server so AI agents can create forms, read submissions, and manage your account programmatically — no custom API integration required.

Quick start

Three steps to connect your first AI agent.

1
Generate an API key
Go to Dashboard → Settings, click Generate API key, and copy the key that appears. Keep it secret — it grants full access to your forms and submissions.

Add the server to your client

Paste the following into your MCP client config, replacing YOUR_API_KEY with the key from step 1.

claude_desktop_config.json

{
  "mcpServers": {
    "form-dump": {
      "url": "https://formdump.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

3
Start talking to your forms
Restart your AI client and ask it something like "List my forms" or "Create a form called Contact and give me the submission URL". The agent will call the right tool automatically.

Connection details

The server uses the Streamable HTTP transport — the standard for remote MCP servers. It is stateless: each request is fully independent, so no persistent connection is required.

Property	Value
URL	https://formdump.com/api/mcp
Transport	Streamable HTTP
Auth	Authorization: Bearer <api_key>
Session mode	Stateless

Available tools

The server exposes seven tools covering the full lifecycle of forms and submissions.

list_forms

no parameters

Returns every form in your account with its ID, name, creation date, submission count, and submission endpoint URL.

get_form

Returns details for a single form.

form_idstring — The ID of the form to look up.

create_form

Creates a new form and returns its ID and the HTTPS endpoint to which HTML forms or API clients should POST submissions.

namestring — A human-readable label for the form (e.g. Contact form).

delete_form

irreversible

Permanently deletes the form and every submission it contains.

form_idstring — The ID of the form to delete.

list_submissions

Returns submissions for a form, newest first. Supports pagination and optional spam inclusion.

form_idstring — The form to query.

limitnumber · optional — Maximum results to return. Defaults to 25, max 100.

offsetnumber · optional — Number of results to skip for pagination. Defaults to 0.

include_spamboolean · optional — Include spam-flagged submissions. Defaults to false.

get_submission

Returns the full data payload for a single submission, including its spam score and timestamp.

form_idstring — The form the submission belongs to.

submission_idstring — The submission ID.

delete_submission

irreversible

Permanently deletes a single submission.

form_idstring — The form the submission belongs to.

submission_idstring — The submission to delete.

Example prompts

Natural language requests your agent can handle once the server is connected.

List all my forms and how many submissions each has received.

Create a form called 'Job Applications' and give me the endpoint URL.

Show me the last 10 submissions from my Contact form.

Delete all spam submissions from form abc123.

Read the most recent submission and summarise it.

Security

A few things worth knowing about how API keys work.

One key per account

Each account has at most one MCP API key at a time. Generating a new key immediately invalidates the previous one.

Full account scope

The key grants access to all forms and submissions in your account. Treat it like a password — do not commit it to source control or share it publicly. Use environment variables or a secrets manager to store it.

Revoking a key

Go to Dashboard → Settings and click Revoke. All MCP clients using the old key will immediately lose access. Generate a new key whenever you need to reconnect.

Questions? Contact support