MCP tool · Applications

manage_app

Read, install, update, back up, log in to, configure or uninstall one Installatron application.

manage_app

D Destructive

Scope read:hosting

Destructive

Description

Read, install, update, back up, log in to, configure or uninstall one Installatron application. action=detail returns one record and needs read:hosting; install needs application and installs asynchronously, returning any generated admin password once in admin.password (https when the domain has or can get a certificate; a result saying dnsPointsHere:false means the domain does not point here yet — call create_temporary_url right after so the customer can open the app); update needs app_id; backup takes an on-demand backup (see it in list_app_backups); configure sets the auto-update policy (autoup: none/minor/all, autoup_plugins/autoup_themes/autoup_backup: none/all) and/or title. Those need write:hosting. sso returns a one-time admin login URL for any app (needs sso:hosting; for WordPress create_wordpress_admin_link is the same thing).

Input

Name	Type	Description
`input` required	string	A domain, email address, website URL, numeric service id, or hosting-account username the customer actually owns. Resolved to the owning account automatically; the resolved `target` is echoed back in the response.
`action` required	enum	`detail` one app, `install` a new one, `update` one, `backup` one now, `sso` a one-time admin login, `configure` auto-updates/title, `uninstall` one, or `delete_backup` (the last two are confirmation-tier, need `delete:hosting`). One of `detail`, `install`, `update`, `backup`, `sso`, `configure`, `uninstall`, `delete_backup`.
`app_id`	string	The application id, from `list_apps` (`apps[].id`). Optional when `url` or `path` names the install instead — prefer those: they are the address the customer used and cannot be mis-copied; with none given the app at the domain root is meant.
`url`	string	Instead of `app_id`: the install's address as listed, e.g. `https://example.com/shop` (scheme and trailing slash do not matter).
`backup_id`	string	For `delete_backup`: the backup id from `list_app_backups` (`backups[].id`).
`application`	string	For `install`: the application to install (e.g. `wordpress`), an id from the REST `GET /apps/available`.
`title`	string	For `install` or `configure`: the site title. Letters, digits, spaces and `._,-` only.
`admin_username`	string	Optional for `install`: the application admin username (letters, digits, `-_`). Installatron generates one if omitted.
`admin_email`	string	Optional for `install`: the application admin email address.
`version`	string	Optional for `install`: a specific version to install. Omit for the latest.
`path`	string	For `install`: the subfolder to install into (e.g. `shop`); omit for the domain root.
`autoup`	enum	For `configure`: core auto-update policy — `none`, `minor` (security/minor only) or `all`. One of `none`, `minor`, `all`.
`autoup_plugins`	enum	For `configure`: plugin auto-update policy. One of `none`, `all`.
`autoup_themes`	enum	For `configure`: theme auto-update policy. One of `none`, `all`.
`autoup_backup`	enum	For `configure`: whether a backup is taken before each auto-update. One of `none`, `all`.
`attempt_key`	string	An idempotency key you choose for an `uninstall`/`delete_backup`. Reusing it within an hour returns the same held action.

inputSchema

{3 keys}

:{16 keys},

:{2 keys},

:"A domain, email address, website URL, numeric service id, or hosting-account username the customer actually owns. Resolved to the owning account automatically; the resolved `target` is echoed back in the response.",

:"string"

:{3 keys},

:"`detail` one app, `install` a new one, `update` one, `backup` one now, `sso` a one-time admin login, `configure` auto-updates/title, `uninstall` one, or `delete_backup` (the last two are confirmation-tier, need `delete:hosting`).",

:[8 items],

"detail",

"install",

"update",

"backup",

"sso",

"configure",

"uninstall",

"delete_backup"

:"string"

:{2 keys},

:"The application id, from `list_apps` (`apps[].id`). Optional when `url` or `path` names the install instead — prefer those: they are the address the customer used and cannot be mis-copied; with none given the app at the domain root is meant.",

:"string"

:{2 keys},

:"Instead of `app_id`: the install's address as listed, e.g. `https://example.com/shop` (scheme and trailing slash do not matter).",

:"string"

:{2 keys},

:"For `delete_backup`: the backup id from `list_app_backups` (`backups[].id`).",

:"string"

:{2 keys},

:"For `install`: the application to install (e.g. `wordpress`), an id from the REST `GET /apps/available`.",

:"string"

:{2 keys},

:"For `install` or `configure`: the site title. Letters, digits, spaces and `._,-` only.",

:"string"

:{2 keys},

:"Optional for `install`: the application admin username (letters, digits, `-_`). Installatron generates one if omitted.",

:"string"

:{2 keys},

:"Optional for `install`: the application admin email address.",

:"string"

:{2 keys},

:"Optional for `install`: a specific version to install. Omit for the latest.",

:"string"

:{2 keys},

:"For `install`: the subfolder to install into (e.g. `shop`); omit for the domain root.",

:"string"

:{3 keys},

:"For `configure`: core auto-update policy — `none`, `minor` (security/minor only) or `all`.",

:[3 items],

"none",

"minor",

"all"

:"string"

:{3 keys},

:"For `configure`: plugin auto-update policy.",

:[2 items],

"none",

"all"

:"string"

:{3 keys},

:"For `configure`: theme auto-update policy.",

:[2 items],

"none",

"all"

:"string"

:{3 keys},

:"For `configure`: whether a backup is taken before each auto-update.",

:[2 items],

"none",

"all"

:"string"

:{2 keys}

:"An idempotency key you choose for an `uninstall`/`delete_backup`. Reusing it within an hour returns the same held action.",

:"string"

}

:"object",

:[2 items]

"input",

"action"

]

}

Click a key to copy its jq path.

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "manage_app",
    "arguments": {
      "input": "example.se",
      "action": "detail"
    }
  }
}

A representative call with its required arguments filled.