← Index

io.form/uag

io.form/uag·v1.11.2·Other
Quality Score
84
/100

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

§01  Install
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "uag": {
      "command": "npx",
      "args": [
        "-y",
        "@formio/uag"
      ],
      "env": {
        "PROJECT": "<project>",
        "PROJECT_KEY": "<your-project_key>",
        "ADMIN_KEY": "<your-admin_key>",
        "UAG_LICENSE": "<your-uag_license>",
        "JWT_SECRET": "<your-jwt_secret>",
        "PORT": "<port>",
        "PROJECT_TTL": "<project_ttl>",
        "JWT_EXPIRE_TIME": "<jwt_expire_time>",
        "PORTAL_SECRET": "<your-portal_secret>",
        "MONGO": "<your-mongo>",
        "MONGO_CONFIG": "<mongo_config>",
        "BASE_URL": "<base_url>",
        "LOGIN_FORM": "<login_form>",
        "CORS": "<cors>",
        "DEBUG": "<debug>"
      }
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "uag": {
      "command": "npx",
      "args": [
        "-y",
        "@formio/uag"
      ],
      "env": {
        "PROJECT": "<project>",
        "PROJECT_KEY": "<your-project_key>",
        "ADMIN_KEY": "<your-admin_key>",
        "UAG_LICENSE": "<your-uag_license>",
        "JWT_SECRET": "<your-jwt_secret>",
        "PORT": "<port>",
        "PROJECT_TTL": "<project_ttl>",
        "JWT_EXPIRE_TIME": "<jwt_expire_time>",
        "PORTAL_SECRET": "<your-portal_secret>",
        "MONGO": "<your-mongo>",
        "MONGO_CONFIG": "<mongo_config>",
        "BASE_URL": "<base_url>",
        "LOGIN_FORM": "<login_form>",
        "CORS": "<cors>",
        "DEBUG": "<debug>"
      }
    }
  }
}
Cline (cline_mcp_settings.json)
npx -y @formio/uag
§02  Environment variables
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
requiredsecret

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

Public URL that the UAG is hosted on

LOGIN_FORM

Public URL to login form JSON endpoint

CORS

CORS domain or JSON configuration (default: *)

DEBUG

Debug logging filter (e.g. formio.*)

§03  MCP Quality Score  ·  methodology
freshness
24
completeness
10
installability
25
documentation
15
stability
10
§04  Alternatives in Other