formio-mcp

{
  "name": "io.form/formio-mcp",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "version": "1.0.1",
  "packages": [
    {
      "version": "1.0.1",
      "transport": {
        "type": "stdio"
      },
      "identifier": "@formio/mcp",
      "registryType": "npm",
      "environmentVariables": [
        {
          "name": "FORMIO_PROJECT_URL",
          "format": "string",
          "description": "Optional, and the WEAKEST of the three project sources: a committed formio.json found by walking up from the working directory wins, then the per-directory mapping project_set writes, then this. It pins nothing — project_set can redirect a directory whose environment names a different project. Useful for a launch with nowhere to record a project, such as CI or a container (e.g. https://examples.form.io on the hosted cloud; self-hosted it is either https://your-project.your-domain.com or https://your-host/project-name, depending on how that deployment routes projects). Leave it unset and the agent asks for a project and records it per directory."
        },
        {
          "name": "FORMIO_BASE_URL",
          "format": "string",
          "description": "Optional, and usually unnecessary: the base URL is DERIVED from the project URL — https://api.form.io for a project on a form.io host, the parent path for a project addressed as a sub-directory — and is asked for only when it cannot be derived, which is a path-less project URL on a customer domain. There is no default. Like FORMIO_PROJECT_URL it is the weakest source, behind a committed formio.json and the per-directory mapping."
        },
        {
          "name": "FORMIO_API_KEY",
          "format": "string",
          "isSecret": true,
          "description": "Form.io project API key. Optional — applied only to the project FORMIO_PROJECT_URL names, so set FORMIO_PROJECT_URL beside it; any other project, and every project when it is omitted, uses the browser-based portal login flow to obtain a JWT."
        },
        {
          "name": "FORMIO_LOGIN_FORM",
          "format": "string",
          "description": "URL of a custom login form used by the browser-based portal login flow. Defaults to the deployment's portal login form."
        },
        {
          "name": "FORMIO_AUTH_HOST",
          "format": "string",
          "description": "Address the browser-login page binds to. Optional; defaults to 127.0.0.1. Set it to 0.0.0.0, together with FORMIO_AUTH_PORT, when the server runs in a container or on a remote machine and the login page must be reachable through a published port. 0.0.0.0 exposes the page on every interface for the duration of a login."
        },
        {
          "name": "FORMIO_AUTH_PORT",
          "format": "string",
          "description": "Fixed port for the browser-login page, so a container can publish it (e.g. 43117). Optional; a positive integer, and by default the page takes an ephemeral port."
        },
        {
          "name": "FORMIO_AUTH_TIMEOUT",
          "format": "string",
          "description": "Seconds to wait for a browser login before the call fails with an error naming the remedies. Optional; a positive integer no larger than 2147483, and any other value is ignored. Defaults to 900."
        },
        {
          "name": "FORMIO_FORCE_BROWSER",
          "format": "string",
          "description": "Set to 1 to attempt the browser login even where the server detects it cannot present one (CI, a container, a remote shell with no display). Use it when the login page is reachable from a browser elsewhere."
        },
        {
          "name": "FORMIO_REQUEST_TIMEOUT",
          "format": "string",
          "description": "Seconds a Form.io request may go unanswered before the call fails with a network error naming the URL. Optional; a positive integer no larger than 2147483, and any other value is ignored. Defaults to 60. project_import and project_export wait 300 seconds, or this value when it is longer."
        },
        {
          "name": "FORMIO_INSECURE_TLS",
          "format": "string",
          "description": "Set to 1 to skip TLS certificate verification only for requests to the configured deployment (the hosts of the resolved project URL and base URL); every other host is verified as usual. For local development against self-signed certificates only — never enable in production."
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/formio/ai",
    "source": "github",
    "subfolder": "packages/mcp-server"
  },
  "websiteUrl": "https://form.io",
  "description": "Create and manage Form.io forms, resources, actions, roles, and projects from your AI agent."
}