Bragproof

← Reports

@formio/mcp

Starts with no setup1.0.1npm

Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.

Needs to start: nothing
Returns a result when called with no setup: 2 of 5 tools tried
Contacts while installing and starting: nothing

25tools listed
0hosts contacted
0files written
0.3 sto start
98dependencies

What it contacted

Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.

Starting it

npx -y @formio/mcp@1.0.1

Installing a package runs its code. Use a sandbox for anything you have not read.

Calling its tools

5 tools that take no input and look read-only were called once with nothing. 2 returned a result.

server_statusReturned a result under 0.1 s · 859 characters
form_listNo usable answer tool reported an error: [NOT_CONFIGURED] No Form.io project is configured for /, the MCP server's own working directory, which is the only directory searched be
project_getReturned a result under 0.1 s · 842 characters
project_tag_listNo usable answer tool reported an error: [NOT_CONFIGURED] No Form.io project is configured for /, the MCP server's own working directory, which is the only directory searched be
role_listNo usable answer tool reported an error: [NOT_CONFIGURED] No Form.io project is configured for /, the MCP server's own working directory, which is the only directory searched be

During the calls it contacted nothing it had not already contacted.

Only tools whose names read like looking something up, with no required input, are tried, five at most. Tools that need input, and anything that sounds like it changes or sends something, are not called.

What its tools tell an agent

In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.

Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.

Tools

server_status cwd
Report this server's name and version and how `cwd` resolves to a project, as project_get does. It makes no Form.io request and needs no credentials: call it first when other tools fail.
form_create cwd, form, note, acceptNoHistory
Create a form in the project `cwd` resolves to. Build the form JSON with the formio-schema skill first. On a deployment licensed for revisions, `revisions` defaults to "original". Not for a draft of an existing form ("save a draft", "draft <change>"): use form_update with `draft: true`.
form_get cwd, formIdOrPath, select, draft
Fetch a form definition, by _id or path, from the project `cwd` resolves to. `draft: true` fetches its in-flight draft instead of the published form.
form_list cwd, type, tags, limit, skip, sort, select
List forms from the project `cwd` resolves to, one page at a time, optionally filtered by type and tags.
form_revision_get cwd, formIdOrPath, version
Fetch one immutable form revision from the project `cwd` resolves to. Restore it with form_revert, passing its `_vid`.
20 more tools
form_revision_list cwd, formIdOrPath, limit, skip, sort, select
List a form's published revision summaries in the project `cwd` resolves to, newest first, one page at a time. Read one with form_revision_get, or restore one with form_revert, passing its `_vid`.
form_update cwd, formId, form, note, draft, acceptNoHistory
Update a form in the project `cwd` resolves to: read it with form_get, apply the change using the formio-schema skill, and send the form. Sent fields overwrite, arrays and objects whole; top-level fields left out keep their value. Pass `draft: true` to save a draft instead of the live form; publish it with form_publish, and restore a prior revision with form_revert.
form_publish cwd, formId, note
Publish a form's draft as its live version in the project `cwd` resolves to. Save the draft first with form_update and `draft: true`; a form with no draft fails with NO_DRAFT. Needs the revisions licence (Security Module).
form_revert cwd, formId, version, note
Revert a form in the project `cwd` resolves to back to a prior revision: its components, tags, properties and display replace the live form's. Find it with form_revision_list. Needs the revisions licence (Security Module).
project_export cwd, tag
Export the project `cwd` resolves to as a template (roles, resources, forms, actions). With `tag`, export the template that version tag stored instead — how a workspace's template.json is refreshed; Form.io does not store project-level access with a tag, so that comes from the project's current access.
project_get cwd
Report which Form.io project the working directory resolves to, which deployment hosts it, and which layer supplied each — the preflight before the first call that reads from or writes to a deployment. It uses the resolver every tool uses, so no shell command is needed. Branch on `status`: "ok" — proceed. "not-configured" — relay the message, ask the user for the one value it names, record it with project_set, and call this again. "base-url-unresolved" — the project IS recorded: ask for the Base URL alone, never the Project URL again. Reads only; project_set records a choice.
project_import cwd, template
Import a template's roles, resources, forms and actions into the project `cwd` resolves to, for a first build: build it with the formio-resource-planner skill. Each form it names is replaced, its actions deleted and recreated, and its `access` replaces the project's; change an existing project with the form, role and action tools instead.
project_tag_list cwd, compare
Report the version the project `cwd` resolves to is at (`current`) and its version tags, newest first. With `compare: true`, also report the roles, resources, forms and actions changed since `current` — changes made outside the agent.
project_tag_create cwd, tag, description
Version the project `cwd` resolves to: Form.io snapshots its current state under a semver `tag` with a `description`, and the project is then at that version. Ask the user before calling. Export the version with project_export `tag`.
project_set projectUrl, cwd, baseUrl
Set the active Form.io project for a directory: records its Project URL in ~/.formio/projects.json, keyed by the directory `cwd` resolves to. Call it whenever the user asks to set, change, or switch the project; acknowledging in text persists nothing. No restart is needed. Resolution precedence: a committed formio.json, then this mapping, then FORMIO_PROJECT_URL in the environment, the weakest — so a mapping written here DOES override the environment. `ok` and `projectUrl` on the result report the pair that resolves. Pass projectUrl alone: the Base URL is derived — https://api.form.io for a form.io host, the parent path for a sub-directory project. Pass baseUrl only when the server reports it cannot be derived. A committed formio.json ({"projectUrl": "..."}, plus "baseUrl" only when it cannot be derived) is written by hand in the application's folder; this server reads it and never writes it.
role_create cwd, role
Create a new role in the project `cwd` resolves to.
role_list cwd, limit, skip, sort, select
List the roles defined in the project `cwd` resolves to, one page at a time.
role_update cwd, roleId, role
Update an existing role in the project `cwd` resolves to. Sent fields overwrite, arrays and objects whole; top-level fields left out keep their value.
action_type_list cwd, formId
List the action types available for a form. Returns the whole catalog the server supports in one result.
action_type_get cwd, formId, actionName
Get action type info and settings form schema. Call this before action_create to discover the required settings for the action type.
action_create cwd, formId, action
Create a new action on a form. Call action_type_get first to discover the required settings schema for the action type.
action_list cwd, formId, limit, skip, sort, select
List the actions configured on a form, one page at a time — the server-side handlers that run when a submission is saved, such as save-to-resource, email, login, and role assignment.
action_get cwd, formId, actionId
Get a single action by ID from a form, including its handler, method, condition, and type-specific settings. Call action_list first to find the action ID.
action_update cwd, formId, actionId, action
Update an existing action on a form; call action_get first if you do not already have it. Sent fields overwrite, arrays and objects whole; top-level fields left out keep their value.
action_delete cwd, formId, actionId
Delete an action from a form. The action stops running on submissions immediately and is not recoverable — call action_get first if the settings may be needed again.

Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.

Install facts

LicenseMIT
Needsnode >=22.12
Sourcegithub.com/formio/ai
Install scriptsNone declared by it or anything installed with it.
Tarballsha512-fZ7YZaigL085dY4FDAo8bTfkH80F6YlkO1BC3/fL4HWMF5QSBS78pMG0dt/zxQdX0GDs8HRUjFAnFgfUjWrvnw==

Check this report yourself

This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.

Show it on your README

Bragproof: Starts with no setup

[![Bragproof](https://bragproof.smaverk.com/badge/@formio/mcp.svg)](https://bragproof.smaverk.com/r/%40formio/mcp)

New version out? Ask for a fresh report.