---
title: "corestack_mariadb_version_change"
url: https://docs.corefinity.com/mcp/tools/corestack_mariadb_version_change
type: tool
last_updated: 2026-11-13
feature: php-runtime
related:
  - https://docs.corefinity.com/guides/sites/software-and-services/php-version.md
---
# corestack_mariadb_version_change

**Change the MariaDB version.** Move a row's MariaDB one version forward, now or tonight. Versions only go forward, one step at a time. Scope: write. Long-running: answers with a task.

- Scope: `write`
- Runs as a task: yes

## When to use it

Move a row's MariaDB one version forward, now or tonight. Versions only go forward, one step at a time.

## Inputs

- `site_id` (integer, ≥ 1, required): The row: the site or one of its environments.
- `to` (string, up to 8 characters, required): The next MariaDB version, e.g. 11.4.
- `apply` (one of `now`, `tonight`, default `"now"`): now (the default), or tonight in the row's maintenance window.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "apply": {
      "default": "now",
      "description": "now (the default), or tonight in the row's maintenance window. window: the row's next maintenance window (tonight is kept as its alias).",
      "enum": [
        "now",
        "window",
        "tonight"
      ],
      "type": "string"
    },
    "site_id": {
      "description": "The row: the site or one of its environments.",
      "minimum": 1,
      "type": "integer"
    },
    "to": {
      "description": "The next MariaDB version, e.g. 11.4.",
      "maxLength": 8,
      "type": "string"
    }
  },
  "required": [
    "site_id",
    "to"
  ],
  "type": "object"
}
```

## Refusals

- `invalid_arguments`: `to` is not the next MariaDB version this row is offered: versions move forward, one step at a time. A Shopware or Shopware 5 site runs MariaDB 11.4 and 11.8 only, so 12.3 is refused for it ("Shopware 5 runs MariaDB 11.4 and 11.8 only").
- `feature_off`: `apply: "tonight"` needs the maintenance window queue, which is switched off; leave `apply` out to make the change now.
- `change_pending`: a change is already queued for this row's maintenance window; apply or cancel it first (corestack_pending_changes_list).
- `busy`: another change is running on this row; wait for it (corestack_site_operation_get) and call again.
- `not_available`: this row's MariaDB version is not managed here; stop.
- `invalid_arguments` with `detail_reason` `not_available` and no field: a previous upgrade has not finished (the message says so, and to contact support); stop.
- `invalid_arguments`: a Magento 2 row moves only to a version its Magento version lists (the refusal names them, e.g. "Magento 2.4.8-p5 runs MariaDB 11.4 and 11.8 only"); until the site's Magento version is known, only up to 11.8 is offered.
- `temporarily_unavailable`: the site's live status could not be read, or the site is not running normally; try again in a minute.
- `removed`: the row has been removed.
- `managed_elsewhere` (message: "This site is managed by another control panel"): another control panel manages this site, so use that control panel for it. This is refused before anything else about the site, as in the Control Panel and the API. Nothing was done.
- `image_not_offered` (409): the MariaDB version this change needs is not one Corefinity offers right now (withdrawn, or not published yet). Nothing was changed; send it again once Corefinity offers that version.
- The refusals every tool can answer: `invalid_arguments`, `tenant_mismatch`, `scope_required`, `pin_refused`, `rate_limited`, `temporarily_unavailable`, `internal_error` (corestack://guides/how-this-server-works).

## Example

```json
{
  "name": "corestack_mariadb_version_change",
  "arguments": {
    "site_id": 4211,
    "to": "11.4"
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_mariadb_version_change with site_id 4211, to 11.4. (Change the MariaDB version.) Tell me what it returned.
```

## The same task elsewhere

- Guide: [Change PHP version](https://docs.corefinity.com/guides/sites/software-and-services/php-version.md)
