@aldform/mcp

Model Context Protocol server for managing Aldform forms and submissions from any MCP-compatible AI client (Claude, Cursor, Windsurf, Antigravity, etc.).

Quick Install

Claude Code

claude mcp add-json aldform '{"command":"npx","args":["-y","@aldform/mcp","aldform-mcp"],"env":{"ALDFORM_API_KEY":"your_api_key"}}'

Claude Desktop / Antigravity / Other MCP Clients

Add to your MCP config (claude_desktop_config.json, mcp_config.json, etc.):

{
  "mcpServers": {
    "aldform": {
      "command": "npx",
      "args": ["-y", "@aldform/mcp", "aldform-mcp"],
      "env": {
        "ALDFORM_API_KEY": "your_api_key_here"
      }
    }
  }
}

Tools

| Tool | Description | |------|-------------| | create_form | Create a new form to collect submissions | | list_forms | List all your forms with submission counts | | get_submissions | Get paginated submissions for a form | | get_submission | Get a single submission with full data | | delete_form | Delete a form and all its submissions | | get_docs | Read Aldform documentation by topic | | search_docs | Search Aldform docs by keyword |

Getting Your API Key

1. Sign up at app.aldform.com
2. Go to Dashboard → Billing to find your API key
3. Or check any form's Setup Guide tab

How It Works

• Transport: stdio — your AI client spawns npx aldform-mcp as a local process
• Authentication: Your ALDFORM_API_KEY env var authenticates all API requests
• No database needed: Calls the hosted Aldform API. No DATABASE_URL or local setup required
• Input validation: All tool arguments validated with Zod schemas
• Ownership enforcement: Users can only access their own forms and submissions

Requirements

• Node.js 18+