---
title: "PageVitals integration for LuumenAI"
url: "https://www.luumen.ai/integrations/pagevitals/"
entity: SoftwareIntegration
category: "Databases & data platforms"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# PageVitals integration for LuumenAI

Read page performance data, then change budgets and tests with approval

## What LuumenAI can do with PageVitals

LuumenAI connects to PageVitals with an API token and exposes 28 tools (15 read-only · 9 write · 4 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 28 tools (15 read-only · 9 write · 4 destructive)
- Plan: available on all plans
- Category: Databases & data platforms

## About PageVitals with LuumenAI

Connect PageVitals and your agent can read Lighthouse scores, real-user metrics, synthetic test results, waterfalls, and budget status for any monitored page. When something needs to change — a tighter budget, a new page under monitoring, a test run before release — the agent plans the change and waits for your approval before it lands.

## Example tools

Read-only (15 in total):

- `PAGE_VITALS_GET_MULTISTEP_TEST` — Get one multistep test definition, including its configured steps.
- `PAGE_VITALS_GET_PAGE_METRICS` — Get the latest Lighthouse and Chrome UX metrics for one configured page and device.
- `PAGE_VITALS_GET_PAGE_OPPORTUNITIES` — List Lighthouse improvement opportunities for a page/device, or return the full variable-shape details for one opportunity ID.
- `PAGE_VITALS_GET_PAGE_TIMELINE` — Get one historical timeline for a page/device: combined loading metrics, CrUX, network bytes, CPU time, or Google Search performance.
- `PAGE_VITALS_GET_TEST` — Get the detailed Lighthouse, timing, resource, budget, and validation summary for one synthetic test.
- `PAGE_VITALS_GET_TEST_REPORT` — Get one specialized synthetic-test report: keyed Lighthouse opportunities, the request waterfall, or grouped HTML validation findings.
- `PAGE_VITALS_GET_TEST_SERIES` — Get one synthetic test series and its individual tests, statuses, page IDs, device variants, and failure messages.
- `PAGE_VITALS_LIST_BUDGETS` — List performance budgets, current status, notification settings, and affected pages for a website.

Write and destructive (13 in total, approval required by default):

- `PAGE_VITALS_ADD_CONFIGURED_PAGES` — Add one or more explicitly supplied pages to PageVitals monitoring for a website.
- `PAGE_VITALS_CREATE_BUDGET` — Create a persistent PageVitals performance budget for a website.
- `PAGE_VITALS_CREATE_MULTISTEP_TEST` — Create an empty PageVitals multistep test definition with an explicit name and device profile.
- `PAGE_VITALS_CREATE_WEBSITE` — Add a domain to the PageVitals account and begin managing it.
- `PAGE_VITALS_DELETE_BUDGET` — Delete one PageVitals performance budget and stop enforcing its threshold.
- `PAGE_VITALS_DELETE_CONFIGURED_PAGE` — Permanently delete one PageVitals configured page and all of its test results, including historical results.
- `PAGE_VITALS_DELETE_MULTISTEP_TEST` — Permanently delete one PageVitals multistep test definition.
- `PAGE_VITALS_DELETE_WEBSITE` — Permanently delete one PageVitals website and all of its tests, metrics, analytics, and configuration.

## Frequently asked questions

### How does LuumenAI connect to PageVitals?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in PageVitals on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default, including the 4 actions classified as destructive. Administrators configure that per tool.

### Is there an audit trail?

Every call to PageVitals — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/pagevitals/