Formio Uag MCP server
io.form/formio-uag·v1.13.2·11 starsThe Universal Agent Gateway (UAG) enables in-process agentic automation using Form.io.
11 stars29 downloads/wk
Reviews
Write oneNobody has reviewed Formio Uag yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Formio Uag tools (10, 2 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
agent_provide_dataProvides a mechanism for agents to process existing submission data, understand it, and then to provide additional data values provided a criteria and form context.
collect_field_dataCollect data for a form, or a specific field with nested components. Identify the component by its path, validate the provided value, and update the form_data object. After updating, determine the next required field to collect or indicate if all required fields are complete. PREREQUISITE: This tool should only be called after the `get_form_fields` tool AND subsequentially the `get_field_info` too
confirm_form_submissionShow a summary of the collected form data if the user wishes to see a summary of the collected data
fetch_external_dataFetch external data for a component that loads data from an external URL, a Form.io Resource, or a DataSource. Use this tool when `get_form_fields` indicates that a field requires calling `fetch_external_data` to retrieve its data. For select components, this returns the available options. For datasource components, this returns the fetched data. You can optionally provide a `search_value` to filt
find_submissionsFind existing form submissions based on field values (search query). Use this to search for people, records, or data by name, email, phone, position, company, or other field values. Examples: find a contact by name, find someone who works at a company, find records with specific criteria. To retrieve the total count of records within a form, use this tool without providing a `search_query`.
get_field_infoGet detailed information about a specific field(s) that have been provided from the user. It is used to understand the properties, validation rules, and options of the specific field(s) the user has provided values for. This purpose of this tool is to provide detailed information for any field(s) (provided using the `field_paths` parameter) to help understand the structure and requirements of a fo
get_form_fieldsGet high level overview of the fields that are present in a form, and to understand the "rules" on how the data for each field type should be collected. The purpose of this tool is to determine what fields the user is requesting (and to understand how to format that values for that data), and use that to create a list of field data_path's that the user is providing context for. This list can then
get_formsGet a list of all available forms with their descriptions. Use this tool when a user expresses intent to add, create, submit, fill out, register for something (e.g., "I want to add a new Contact", "I need to submit a User Registration", "I met a contact who was the CMO", "What was the email of the contact"). This tool can also be used when they ask what forms are available.
submission_updatewrite actionApply multiple planned field updates to a selected submission after the user confirmed they wish to update the record.
submit_completed_formwrite actionSubmit the completed form data. Should only be used once all the required fields have been collected, and the user has explicitly confirmed submission (e.g. has said "submit", "send", "done", etc)
Public scan report
scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it
- Code scan41 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 1 days ago15/15
- Maintainer identitynamespace and repository owner differ; GitHub account older than a year; website matches verified namespace8/10
How Formio Uag compares
Against every graded AI and agents MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 68% of 4,460 AI and agents servers
- Tools
- 10
- the typical AI and agents server has 6
- Tools that change things
- 20%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 11
- more than 85% of 2,711 AI and agents servers
- Downloads a week
- 29
- more than 15% of 1,538 AI and agents servers with a package
What its tools let an agent do: 8 read · 2 change
Install Formio Uag in Claude Code, Cursor or VS Code
Runs npx -y @formio/uag on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add formio-uag -- npx -y @formio/uag
What the publisher says
From the Formio Uag repository's README, as published. We do not edit it. Read it on GitHub
The Universal Agent Gateway (UAG) leverages the Model Context Protocol (MCP) to enable in-process agentic automation using Form.io. It provides to an AI Agent the same thing that our JavaScript Renderer provides to a human; an interpretation of the Form JSON schema into an understandable format. In the case of UAG, it transforms the Form JSON model into an AI readible markdown format so that the Agent can easily understand the purpose and structure of the data that needs to be collected.
There are two primary scenarios that the UAG enables:
- Unstructured 'chat' input to deterministic form submission: This capability uses the JSON schema of a Form.io form to produce a deterministic structured data object provided natural language conversational input.
For a working example of this flow, please try out the Conversation Form Example.
- Agentic Form.io Workflows: UAG provides an AI Agent the ability to take existing submission data + "context" criteria in order to prompt an AI Agent to provide its own data and analysis within a workflow scenario. The following example, which shows a college application process using a Form.io application form, shows how this primary scenario works.
For more information on Agentic workflows, checkout the dedicated Agentic Workflows section. For a working example of this flow, please try out the Agentic Workflow Example.
One of the many benefits that the UAG has to offer is the ability to inject Dynamic Context into an AI processing cycle. This is achieved from the dynamic nature of the Form JSON schemas that can easily be modified and deployed to any environment without the need to update your application or re-train the agents within the process. Because of this, dynamic context changes can be injected seamlessly into an existing running process which will automatically update the behaviors of the Agents utilizing the UAG.
Try it out!
There are three working examples in this repo, each spinning up a Form.io server alongside the UAG with Docker Compose. Pick the one that matches what you are building.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Formio Uag: common questions
- Is Formio Uag MCP server safe?
- Mostly: it is graded B (83/100). Read the Formio Uag safety report
- How do I install Formio Uag?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Formio Uag need an API key?
- Yes. The registry entry asks for
PROJECT_KEY,ADMIN_KEY,UAG_LICENSE,JWT_SECRETand 2 more. - Is Formio Uag maintained?
- The last commit was 42 days ago (2026-09-23). The latest release is v1.13.2.
- What can I use instead of Formio Uag?
- Servers from other publishers that do the same job: Agent-Native Forms MCP server, freellmpool MCP server and PDF MCP server.
- How does Formio Uag compare with other AI and agents MCP servers?
- safety score 83/100 (higher than 68% of 4,460 AI and agents servers); tools 10 (the typical AI and agents server has 6); tools that change things 20% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Formio Uag
Same job from other publishers: the closest match first, then the best rated.
- Agent-Native FormsAgent-Native form builder - create, edit, and manage formsnot reviewedEstablishedA
- freellmpoolOpenAI-compatible MCP gateway cataloging 22 LLM providers, with routing, failover, and tools.not reviewedEstablishedA
- PDFAgentic RAG over one PDF or a whole folder: hybrid search, selective page reads, tables, OCR.not reviewedEstablishedA