AgentForm MCP Server

An MCP server that lets AI agents (Claude Code, Cursor, etc.) fill and submit AgentForm forms.

Tools

| Tool | Description | |------|-------------| | get_form | Retrieve form schema by URL or ID/slug | | start_session | Start a new fill session | | fill_form | Fill one or more fields (mergeable, call multiple times) | | get_session | Review current session state before submitting | | submit_form | Submit the completed form |

Setup

1. Build the server

cd mcp-server
npm install
npm run build

2. Add to Claude Code (~/.claude/claude_desktop_config.json)

{
  "mcpServers": {
    "agentform": {
      "command": "node",
      "args": ["/absolute/path/to/AgentForm/mcp-server/dist/index.js"],
      "env": {
        "AGENTFORM_BASE_URL": "http://localhost:3000"
      }
    }
  }
}

3. Add to Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "agentform": {
      "command": "node",
      "args": ["/absolute/path/to/AgentForm/mcp-server/dist/index.js"],
      "env": {
        "AGENTFORM_BASE_URL": "http://localhost:3000"
      }
    }
  }
}

Restart your AI assistant after updating the config.

Usage example

In a Claude Code session:

I need to fill this form: http://localhost:3000/forms/my-form-abc1

Here's my context:
- Name: Jane Smith
- Email: [email protected]
- ...

The agent will:

1. Call get_form to read the schema
2. Call start_session to create a session
3. Call fill_form with inferred answers
4. Ask you for any missing required fields
5. Call get_session to review with you
6. Call submit_form to submit

Environment variables

| Variable | Default | Description | |----------|---------|-------------| | AGENTFORM_BASE_URL | http://localhost:3000 | Base URL of the AgentForm app |