{"report":{"v":1,"package":"@formio/mcp","version":"1.0.1","ranAt":"2026-11-16T11:43:44.604Z","install":{"ok":true,"integrity":"sha512-fZ7YZaigL085dY4FDAo8bTfkH80F6YlkO1BC3/fL4HWMF5QSBS78pMG0dt/zxQdX0GDs8HRUjFAnFgfUjWrvnw==","deps":98,"scripts":[],"bins":["formio-mcp"],"license":"MIT","engines":"node >=22.12","repository":"git+https://github.com/formio/ai.git","bin":"formio-mcp"},"start":{"ok":true,"ms":260,"serverName":"formio-mcp","serverVersion":"1.0.1","protocol":"2025-06-18"},"tools":[{"name":"server_status","description":"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.","params":["cwd"]},{"name":"form_create","description":"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`.","params":["cwd","form","note","acceptNoHistory"]},{"name":"form_get","description":"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.","params":["cwd","formIdOrPath","select","draft"]},{"name":"form_list","description":"List forms from the project `cwd` resolves to, one page at a time, optionally filtered by type and tags.","params":["cwd","type","tags","limit","skip","sort","select"]},{"name":"form_revision_get","description":"Fetch one immutable form revision from the project `cwd` resolves to. Restore it with form_revert, passing its `_vid`.","params":["cwd","formIdOrPath","version"]},{"name":"form_revision_list","description":"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`.","params":["cwd","formIdOrPath","limit","skip","sort","select"]},{"name":"form_update","description":"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.","params":["cwd","formId","form","note","draft","acceptNoHistory"]},{"name":"form_publish","description":"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).","params":["cwd","formId","note"]},{"name":"form_revert","description":"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).","params":["cwd","formId","version","note"]},{"name":"project_export","description":"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.","params":["cwd","tag"]},{"name":"project_get","description":"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.","params":["cwd"]},{"name":"project_import","description":"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.","params":["cwd","template"]},{"name":"project_tag_list","description":"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.","params":["cwd","compare"]},{"name":"project_tag_create","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`.","params":["cwd","tag","description"]},{"name":"project_set","description":"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.","params":["projectUrl","cwd","baseUrl"]},{"name":"role_create","description":"Create a new role in the project `cwd` resolves to.","params":["cwd","role"]},{"name":"role_list","description":"List the roles defined in the project `cwd` resolves to, one page at a time.","params":["cwd","limit","skip","sort","select"]},{"name":"role_update","description":"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.","params":["cwd","roleId","role"]},{"name":"action_type_list","description":"List the action types available for a form. Returns the whole catalog the server supports in one result.","params":["cwd","formId"]},{"name":"action_type_get","description":"Get action type info and settings form schema. Call this before action_create to discover the required settings for the action type.","params":["cwd","formId","actionName"]},{"name":"action_create","description":"Create a new action on a form. Call action_type_get first to discover the required settings schema for the action type.","params":["cwd","formId","action"]},{"name":"action_list","description":"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.","params":["cwd","formId","limit","skip","sort","select"]},{"name":"action_get","description":"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.","params":["cwd","formId","actionId"]},{"name":"action_update","description":"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.","params":["cwd","formId","actionId","action"]},{"name":"action_delete","description":"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.","params":["cwd","formId","actionId"]}],"toolsHash":"43e6222d3f1282d34acaf2edd931e76a2058c3d7705d6f150f3f639b23a36d69","wrote":[],"callsAt":"2026-11-16T11:43:51.328Z","calls":[{"tool":"server_status","ok":true,"ms":5,"bytes":859},{"tool":"form_list","ok":false,"ms":2,"bytes":0,"error":"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 because no cwd argument was passed and the client named no directo"},{"tool":"project_get","ok":true,"ms":1,"bytes":842},{"tool":"project_tag_list","ok":false,"ms":0,"bytes":0,"error":"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 because no cwd argument was passed and the client named no directo"},{"tool":"role_list","ok":false,"ms":1,"bytes":0,"error":"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 because no cwd argument was passed and the client named no directo"}],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[],"callNames":[],"callConns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[],"tools":25,"wrote":0,"callsTried":5,"callsAnswered":2,"callContacts":[]},"history":[{"package":"@formio/mcp","version":"1.0.1","ranAt":"2026-11-16T11:43:44.604Z","outcome":"started","tools":25,"contacts":0,"flags":0,"serious":0,"toolsHash":"43e6222d3f1282d34acaf2edd931e76a2058c3d7705d6f150f3f639b23a36d69"}],"page":"https://bragproof.smaverk.com/r/%40formio/mcp"}