MCP Server

io.form/formio-uag MCP Server

Name: io.form/formio-uag MCP Server
Author: io.form

io.form/formio-uag

Repository Registry

What is the io.form/formio-uag MCP server?

The Universal Agent Gateway (UAG) enables in-process agentic automation using Form.io.

How to install io.form/formio-uag

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

PROJECT
required
API endpoint to Enterprise project or OSS server
PROJECT_KEY
secret
Project API Key (Enterprise) or ADMIN_KEY (OSS)
ADMIN_KEY
secret
Server admin key for Community Edition. Not required for Enterprise deployment.
UAG_LICENSE
secret
License for Enterprise deployment. Not required for Community Edition.
JWT_SECRET
required
secret
Secret used to generate and validate JWT tokens
PORT
Server port (default: 3200)
PROJECT_TTL
Project cache refresh interval in seconds (default: 900)
JWT_EXPIRE_TIME
JWT token expiration in seconds (default: 3600)
PORTAL_SECRET
secret
Enterprise Portal connection secret
MONGO
secret
Direct MongoDB connection URI (Enterprise)
MONGO_CONFIG
MongoDB driver configuration (JSON)
BASE_URL
required
The URL clients reach the UAG at. Published in the .well-known OIDC (PKCE) definitions and used for authentication callbacks, so remote agents cannot authenticate without it. Must be a public URL when remote agents connect in; a private or localhost URL is fine for a local MCP client.
LOGIN_FORM
Public URL to login form JSON endpoint
CORS
CORS domain or JSON configuration (default: *)
DEBUG
Debug logging filter (e.g. formio.*)

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "formio-uag": {
      "command": "npx",
      "args": [
        "-y",
        "@formio/uag"
      ],
      "env": {
        "PROJECT": "<YOUR_PROJECT>",
        "PROJECT_KEY": "<YOUR_PROJECT_KEY>",
        "ADMIN_KEY": "<YOUR_ADMIN_KEY>",
        "UAG_LICENSE": "<YOUR_UAG_LICENSE>",
        "JWT_SECRET": "<YOUR_JWT_SECRET>",
        "PORT": "<YOUR_PORT>",
        "PROJECT_TTL": "<YOUR_PROJECT_TTL>",
        "JWT_EXPIRE_TIME": "<YOUR_JWT_EXPIRE_TIME>",
        "PORTAL_SECRET": "<YOUR_PORTAL_SECRET>",
        "MONGO": "<YOUR_MONGO>",
        "MONGO_CONFIG": "<YOUR_MONGO_CONFIG>",
        "BASE_URL": "<YOUR_BASE_URL>",
        "LOGIN_FORM": "<YOUR_LOGIN_FORM>",
        "CORS": "<YOUR_CORS>",
        "DEBUG": "<YOUR_DEBUG>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "formio-uag": {
      "command": "npx",
      "args": [
        "-y",
        "@formio/uag"
      ],
      "env": {
        "PROJECT": "<YOUR_PROJECT>",
        "PROJECT_KEY": "<YOUR_PROJECT_KEY>",
        "ADMIN_KEY": "<YOUR_ADMIN_KEY>",
        "UAG_LICENSE": "<YOUR_UAG_LICENSE>",
        "JWT_SECRET": "<YOUR_JWT_SECRET>",
        "PORT": "<YOUR_PORT>",
        "PROJECT_TTL": "<YOUR_PROJECT_TTL>",
        "JWT_EXPIRE_TIME": "<YOUR_JWT_EXPIRE_TIME>",
        "PORTAL_SECRET": "<YOUR_PORTAL_SECRET>",
        "MONGO": "<YOUR_MONGO>",
        "MONGO_CONFIG": "<YOUR_MONGO_CONFIG>",
        "BASE_URL": "<YOUR_BASE_URL>",
        "LOGIN_FORM": "<YOUR_LOGIN_FORM>",
        "CORS": "<YOUR_CORS>",
        "DEBUG": "<YOUR_DEBUG>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "formio-uag": {
      "command": "npx",
      "args": [
        "-y",
        "@formio/uag"
      ],
      "env": {
        "PROJECT": "<YOUR_PROJECT>",
        "PROJECT_KEY": "<YOUR_PROJECT_KEY>",
        "ADMIN_KEY": "<YOUR_ADMIN_KEY>",
        "UAG_LICENSE": "<YOUR_UAG_LICENSE>",
        "JWT_SECRET": "<YOUR_JWT_SECRET>",
        "PORT": "<YOUR_PORT>",
        "PROJECT_TTL": "<YOUR_PROJECT_TTL>",
        "JWT_EXPIRE_TIME": "<YOUR_JWT_EXPIRE_TIME>",
        "PORTAL_SECRET": "<YOUR_PORTAL_SECRET>",
        "MONGO": "<YOUR_MONGO>",
        "MONGO_CONFIG": "<YOUR_MONGO_CONFIG>",
        "BASE_URL": "<YOUR_BASE_URL>",
        "LOGIN_FORM": "<YOUR_LOGIN_FORM>",
        "CORS": "<YOUR_CORS>",
        "DEBUG": "<YOUR_DEBUG>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "formio-uag": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@formio/uag"
      ],
      "env": {
        "PROJECT": "<YOUR_PROJECT>",
        "PROJECT_KEY": "<YOUR_PROJECT_KEY>",
        "ADMIN_KEY": "<YOUR_ADMIN_KEY>",
        "UAG_LICENSE": "<YOUR_UAG_LICENSE>",
        "JWT_SECRET": "<YOUR_JWT_SECRET>",
        "PORT": "<YOUR_PORT>",
        "PROJECT_TTL": "<YOUR_PROJECT_TTL>",
        "JWT_EXPIRE_TIME": "<YOUR_JWT_EXPIRE_TIME>",
        "PORTAL_SECRET": "<YOUR_PORTAL_SECRET>",
        "MONGO": "<YOUR_MONGO>",
        "MONGO_CONFIG": "<YOUR_MONGO_CONFIG>",
        "BASE_URL": "<YOUR_BASE_URL>",
        "LOGIN_FORM": "<YOUR_LOGIN_FORM>",
        "CORS": "<YOUR_CORS>",
        "DEBUG": "<YOUR_DEBUG>"
      }
    }
  }
}

Claude Code

claude mcp add formio-uag --env PROJECT=<YOUR_PROJECT> --env PROJECT_KEY=<YOUR_PROJECT_KEY> --env ADMIN_KEY=<YOUR_ADMIN_KEY> --env UAG_LICENSE=<YOUR_UAG_LICENSE> --env JWT_SECRET=<YOUR_JWT_SECRET> --env PORT=<YOUR_PORT> --env PROJECT_TTL=<YOUR_PROJECT_TTL> --env JWT_EXPIRE_TIME=<YOUR_JWT_EXPIRE_TIME> --env PORTAL_SECRET=<YOUR_PORTAL_SECRET> --env MONGO=<YOUR_MONGO> --env MONGO_CONFIG=<YOUR_MONGO_CONFIG> --env BASE_URL=<YOUR_BASE_URL> --env LOGIN_FORM=<YOUR_LOGIN_FORM> --env CORS=<YOUR_CORS> --env DEBUG=<YOUR_DEBUG> -- npx -y @formio/uag

Related MCP servers

io.form/formio-mcp

Active

Create and manage Form.io forms, resources, actions, roles, and projects from your AI agent.

TypeScript

MIT

View repository →