# Form.io MCP server

> Enables AI agents to build complete applications, forms, and workflows by interacting with the Form.io Enterprise Server via MCP tools and skills.

- Repository: https://github.com/formio/ai
- Page: https://hostedmcp.org/servers/formio/ai
- Transport: stdio
- Stars: 9
- License: MIT

## Install

### Claude Code

```sh
claude mcp add ai -- npx -y @formio/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "ai": {
      "command": "npx",
      "args": [
        "-y",
        "@formio/mcp"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "ai": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@formio/mcp"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"ai","type":"stdio","command":"npx","args":["-y","@formio/mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "ai": {
      "command": "npx",
      "args": [
        "-y",
        "@formio/mcp"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add ai -- npx -y @formio/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.ai]
command = "npx"
args = ["-y", "@formio/mcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user ai npx -- -y @formio/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "ai": {
      "command": "npx",
      "args": [
        "-y",
        "@formio/mcp"
      ]
    }
  }
}
```

## Tools (25)

- `form_create`
- `form_get`
- `form_list`
- `form_update`
- `form_publish`
- `form_revert`
- `form_revision_list`
- `form_revision_get`
- `role_create`
- `role_list`
- `role_update`
- `action_type_list`
- `action_type_get`
- `action_create`
- `action_list`
- `action_get`
- `action_update`
- `action_delete`
- `project_export`
- `project_import`
- `project_tag_list`
- `project_tag_create`
- `project_get`
- `project_set`
- `server_status`

## FAQ

### Can I use this with my own self-hosted Form.io instance?

Yes, the server supports both the Form.io SaaS environment and self-hosted deployments by configuring the Project URL and Base URL.

### How does the orchestration skill work?

Orchestration skills act as entry points that coordinate other skills like planning, schema authoring, and deployment to fulfill broad requests.
