Formio Uag
The Universal Agent Gateway (UAG) enables in-process agentic automation using Form.io.
- 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/uagAdd 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 serverRequiredPROJECT_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 tokensRequiredPORTServer 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 secretMONGOOptional. 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 endpointCORStrue (the default) allows every origin, false turns CORS off, any other value is the allowed origin, or several separated by commasDEBUGDebug 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.