---
title: "corestack_pagespeed_run"
url: https://docs.corefinity.com/mcp/tools/corestack_pagespeed_run
type: tool
last_updated: 2026-11-13
feature: pagespeed
related:
  - https://docs.corefinity.com/api/reference/logs/start-site-page-speed-run.md
  - https://docs.corefinity.com/guides/sites/logs-and-monitoring/pagespeed.md
---
# corestack_pagespeed_run

**Run a PageSpeed test.** Run Google PageSpeed Insights on a live row now, mobile and desktop together. Two manual tests an hour per site; the task ends with both results. Scope: write. Long-running: answers with a task.

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

## When to use it

Run Google PageSpeed Insights on a live row now, mobile and desktop together. Two manual tests an hour per site; the task ends with both results.

## Inputs

- `site_id` (integer, ≥ 1, required)

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "site_id": {
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "site_id"
  ],
  "type": "object"
}
```

## Refusals

- `removed`: the row has been removed.
- `deleted`: the site is deleted (in its grace period); restore it with corestack_site_restore_deleted first.
- `provisioning`: the site is still being created; wait for corestack_site_provisioning_get to finish.
- `preview_only`: the row has no domain attached yet; attach one with corestack_site_attach_domain first.
- `busy`: another change is running on this row; wait for it (corestack_site_operation_get) and call again.
- `maintenance`: the site is in maintenance mode; turn it off first, or wait for the maintenance to end.
- `temporarily_unavailable` with `detail_reason` `switched_off`: Corefinity has switched PageSpeed tests off for now; nothing was started. Try again later, not straight away.
- 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_pagespeed_run",
  "arguments": {
    "site_id": 4211
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_pagespeed_run with site_id 4211. (Run a PageSpeed test.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [POST /api/corestack/sites/{site}/pagespeed/runs](https://docs.corefinity.com/api/reference/logs/start-site-page-speed-run.md)
- Guide: [PageSpeed](https://docs.corefinity.com/guides/sites/logs-and-monitoring/pagespeed.md)
