Skip to content
MCP server

Formio Uag

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

Install
Pricing
Open source
Runs
Remotely
Version
2.0.1
Listing updated
5 days ago

About Formio Uag

Formio Uag is an open-source MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

claude mcp add formio-uag --env PROJECT='<PROJECT>' --env PROJECT_KEY='<PROJECT_KEY>' --env ADMIN_KEY='<ADMIN_KEY>' --env LICENSE_KEY='<LICENSE_KEY>' --env UAG_LICENSE='<UAG_LICENSE>' --env JWT_SECRET='<JWT_SECRET>' --env PORTAL_SECRET='<PORTAL_SECRET>' --env MONGO='<MONGO>' -- npx -y @formio/uag

Add to claude_desktop_config.json

{
  "mcpServers": {
    "formio-uag": {
      "command": "npx",
      "args": [
        "-y",
        "@formio/uag"
      ],
      "env": {
        "PROJECT": "<PROJECT>",
        "PROJECT_KEY": "<PROJECT_KEY>",
        "ADMIN_KEY": "<ADMIN_KEY>",
        "LICENSE_KEY": "<LICENSE_KEY>",
        "UAG_LICENSE": "<UAG_LICENSE>",
        "JWT_SECRET": "<JWT_SECRET>",
        "PORTAL_SECRET": "<PORTAL_SECRET>",
        "MONGO": "<MONGO>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "formio-uag": {
      "command": "npx",
      "args": [
        "-y",
        "@formio/uag"
      ],
      "env": {
        "PROJECT": "<PROJECT>",
        "PROJECT_KEY": "<PROJECT_KEY>",
        "ADMIN_KEY": "<ADMIN_KEY>",
        "LICENSE_KEY": "<LICENSE_KEY>",
        "UAG_LICENSE": "<UAG_LICENSE>",
        "JWT_SECRET": "<JWT_SECRET>",
        "PORTAL_SECRET": "<PORTAL_SECRET>",
        "MONGO": "<MONGO>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "formio-uag": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@formio/uag"
      ],
      "env": {
        "PROJECT": "<PROJECT>",
        "PROJECT_KEY": "<PROJECT_KEY>",
        "ADMIN_KEY": "<ADMIN_KEY>",
        "LICENSE_KEY": "<LICENSE_KEY>",
        "UAG_LICENSE": "<UAG_LICENSE>",
        "JWT_SECRET": "<JWT_SECRET>",
        "PORTAL_SECRET": "<PORTAL_SECRET>",
        "MONGO": "<MONGO>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "formio-uag": {
      "command": "npx",
      "args": [
        "-y",
        "@formio/uag"
      ],
      "env": {
        "PROJECT": "<PROJECT>",
        "PROJECT_KEY": "<PROJECT_KEY>",
        "ADMIN_KEY": "<ADMIN_KEY>",
        "LICENSE_KEY": "<LICENSE_KEY>",
        "UAG_LICENSE": "<UAG_LICENSE>",
        "JWT_SECRET": "<JWT_SECRET>",
        "PORTAL_SECRET": "<PORTAL_SECRET>",
        "MONGO": "<MONGO>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "formio-uag": {
      "command": "npx",
      "args": [
        "-y",
        "@formio/uag"
      ],
      "env": {
        "PROJECT": "<PROJECT>",
        "PROJECT_KEY": "<PROJECT_KEY>",
        "ADMIN_KEY": "<ADMIN_KEY>",
        "LICENSE_KEY": "<LICENSE_KEY>",
        "UAG_LICENSE": "<UAG_LICENSE>",
        "JWT_SECRET": "<JWT_SECRET>",
        "PORTAL_SECRET": "<PORTAL_SECRET>",
        "MONGO": "<MONGO>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • PROJECTAPI endpoint to Enterprise project or OSS serverRequired
  • PROJECT_KEYProject API Key (Enterprise) or ADMIN_KEY (OSS)
  • ADMIN_KEYServer admin key for Form.io Open Source. Not required for Enterprise deployment.
  • LICENSE_KEYForm.io license for a self-hosted Enterprise deployment; when it includes the UAG it also enables the Agent API. Not required for Form.io Open Source, or for a project on Form.io's hosted service (https://*.form.io).
  • UAG_LICENSEDeprecated: use LICENSE_KEY. Still read until UAG 3.0.
  • JWT_SECRETSecret used to generate and validate JWT tokensRequired
  • PORTServer port (default: 3200)
  • PROJECT_TTLProject cache refresh interval in seconds (default: 900)
  • TEMPLATE_SYNCWhen a module's template is installed into the project: boot, refresh or off (default: boot)
  • JWT_EXPIRE_TIMELifetime of the tokens the UAG issues, in minutes (default: 60)
  • PORTAL_SECRETEnterprise Portal connection secret
  • MONGOOptional. The UAG's own database (only uag-* collections, never submissions): run records, runs that survive a restart, remote MCP sign-in. Needs a license that includes the UAG.
  • MONGO_CONFIGMongoDB driver configuration (JSON)
  • UAG_DATABASEThe database to use on the MONGO connection. Default uag.
  • TASK_RUN_RETENTION_DAYSDays run records are kept. Default 90; 0 keeps them forever.
  • BASE_URLOptional. The URL clients reach the UAG at, for the OAuth discovery documents remote MCP clients read. Derived from each request when unset.
  • MCP_OAUTHtrue turns on OAuth sign-in for remote MCP clients. Needs MONGO.
  • TRUST_PROXYExpress's trust proxy (true, a number of hops, or addresses). Set it behind a reverse proxy, so the UAG reads its public URL from the forwarded headers.
  • LOGIN_FORMPublic URL to login form JSON endpoint
  • CORStrue (the default) allows every origin, false turns CORS off, any other value is the allowed origin, or several separated by commas
  • DEBUGDebug logging filter (e.g. formio.*)

Pricing

Open source

Prices change. Check form.io before you buy.

Formio Uag FAQ

Is Formio Uag free?

Yes. Formio Uag is open source, so you can use and self-host it for free.

How do I add Formio Uag to Claude Code?

Run this command in your terminal: claude mcp add formio-uag --env PROJECT='<PROJECT>' --env PROJECT_KEY='<PROJECT_KEY>' --env ADMIN_KEY='<ADMIN_KEY>' --env LICENSE_KEY='<LICENSE_KEY>' --env UAG_LICENSE='<UAG_LICENSE>' --env JWT_SECRET='<JWT_SECRET>' --env PORTAL_SECRET='<PORTAL_SECRET>' --env MONGO='<MONGO>' -- npx -y @formio/uag

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers