MCP Reference

formdata.dev exposes a Model Context Protocol (MCP) server that lets AI assistants manage your forms, destinations, and account.

Endpoint

https://api.formdata.dev/mcp

Authentication

All MCP connections require a Bearer token using your secret key (sk_ prefix):

{
  "mcpServers": {
    "formdata": {
      "url": "https://api.formdata.dev/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_..."
      }
    }
  }
}

Add this to your Claude Desktop configuration or .claude/settings.json.

TIP

Get your secret key by running npx formdata-dev init. If you need to rotate it, use npx formdata-dev keys rotate or the rotate_key tool.

Tool Summary

formdata.dev provides 9 MCP tools organized into three groups:

Account

Tool Description
get_account View your account information
rotate_key Rotate your tenant API key

Forms

Tool Description
list_forms List all forms for your account
create_form Create a new form endpoint
get_form Get form details including destinations
update_form Update form configuration
delete_form Delete a form and all its destinations

Destinations

Tool Description
add_destination Add a destination to a form
remove_destination Remove a destination from a form

Architecture

The MCP server runs as a Durable Object (FormDataMcpAgent) on Cloudflare Workers. Each authenticated connection is scoped to a single organization -- tools can only access forms and destinations belonging to the authenticated tenant.

TIP

Every MCP tool has a CLI equivalent. See the CLI Reference for terminal-based management.