---
title: "corestack_company_performance_audit_request"
url: https://docs.corefinity.com/mcp/tools/corestack_company_performance_audit_request
type: tool
last_updated: 2026-11-13
feature: performance-audits
related:
  - https://docs.corefinity.com/guides/tools/performance-audits.md
---
# corestack_company_performance_audit_request

**Request a performance audit.** Create a performance audit of your sites and run it: each environment's URL loads each page several times, uncached and optionally cached, from the server location you choose. Scope: write. Long-running: answers with a task.

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

## When to use it

Create a performance audit and run it. Each environment's URL loads each page several times from the server location you choose: uncached, and cached too when the page asks for it. Typical use: compare a site on its current host with the same site on Corefinity. The task ends with the audit and its results; follow it, or read the audit with corestack_company_performance_audit_get.

## Inputs

- `name` (string, ≤ 255, required)
- `domains` (array, 1–10, required): each `{environment, url, http_username?, http_password?}`. `environment` names the column (unique, ≤ 100 characters); `url` is http(s). The HTTP username and password open a protected site for the runs; they are stored for later runs and never answered.
- `page_types` (array, 1–20, required): each `{title, path?, check_cache?}`. `title` names the row (unique, ≤ 100 characters); `path` is added to each URL; `check_cache` true also tests the page cached.
- `number_of_requests` (integer, 1–20, default 5): loads per page and cache state.
- `user_agent` (string, ≤ 255, optional): defaults to the Control Panel's.
- `server_location` (integer, optional): a server location id; defaults to the first one.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "domains": {
      "items": {
        "properties": {
          "environment": {
            "maxLength": 100,
            "type": "string"
          },
          "http_password": {
            "maxLength": 255,
            "type": "string"
          },
          "http_username": {
            "maxLength": 255,
            "type": "string"
          },
          "url": {
            "maxLength": 255,
            "type": "string"
          }
        },
        "required": [
          "environment",
          "url"
        ],
        "type": "object"
      },
      "maxItems": 10,
      "minItems": 1,
      "type": "array"
    },
    "name": {
      "maxLength": 255,
      "type": "string"
    },
    "number_of_requests": {
      "default": 5,
      "maximum": 20,
      "minimum": 1,
      "type": "integer"
    },
    "page_types": {
      "items": {
        "properties": {
          "check_cache": {
            "type": "boolean"
          },
          "path": {
            "maxLength": 255,
            "type": "string"
          },
          "title": {
            "maxLength": 100,
            "type": "string"
          }
        },
        "required": [
          "title"
        ],
        "type": "object"
      },
      "maxItems": 20,
      "minItems": 1,
      "type": "array"
    },
    "server_location": {
      "minimum": 1,
      "type": "integer"
    },
    "user_agent": {
      "maxLength": 255,
      "type": "string"
    }
  },
  "required": [
    "name",
    "domains",
    "page_types"
  ],
  "type": "object"
}
```

## Refusals

- `forbidden`: your account cannot create performance audits.
- `temporarily_unavailable`: performance audits cannot run right now; nothing was saved. Try again later.
- 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_company_performance_audit_request",
  "arguments": {
    "name": "Before and after the move",
    "domains": [
      {"environment": "Current host", "url": "https://www.example.com"},
      {"environment": "Corefinity", "url": "https://example-com.cfstack.io"}
    ],
    "page_types": [
      {"title": "Home", "path": "/", "check_cache": true},
      {"title": "Category", "path": "/shop/"}
    ],
    "number_of_requests": 5
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_company_performance_audit_request with name Before and after the move, domains [{"environment":"Current host","url":"https://www.example.com"},{"environment":"Corefinity","url":"https://example-com.cfstack.io"}], page_types [{"title":"Home","path":"/","check_cache":true},{"title":"Category","path":"/shop/"}], number_of_requests 5. (Request a performance audit.) Tell me what it returned.
```

## The same task elsewhere

- Guide: [Performance audits](https://docs.corefinity.com/guides/tools/performance-audits.md)
