PageVitals
PageVitals provides website performance monitoring, synthetic testing, real-user monitoring reports, performance budgets, and optimization insights.
Verdict
Common use cases
- Audit Core Web Vitals before a release
- Set performance budgets for critical pages
- Compare mobile vs desktop load times
- Review synthetic test results in standups
- Delete outdated monitoring configurations
Integration
- Vendor
- PageVitals
- Category
- developer-tools
- Auth
- API_KEY
- Tools
- 28
- Composio slug
page_vitals
Tools
- Add Configured Pages
Add one or more explicitly supplied pages to PageVitals monitoring for a website. This persistent bulk operation can consume monitored-page quota and cause future synthetic tests, so call it only when the user explicitly requests every URL
- Create Budget
Create a persistent PageVitals performance budget for a website. This changes monitoring and may change owner alerting behavior, so call only when the user explicitly requests the budget and supplies the complete metric, comparison directio
- Create Multistep Test
Create an empty PageVitals multistep test definition with an explicit name and device profile. This only saves persistent configuration: it does not run the test, trigger any synthetic checks, or consume test-run quota.
- Create Website
Add a domain to the PageVitals account and begin managing it. This may consume website quota and start monitoring, so call only when the user explicitly asks to add the domain.
- Delete Budgetdestructive
Delete one PageVitals performance budget and stop enforcing its threshold. This is a destructive alerting mutation; use only when the user explicitly selects the exact budget ID for deletion.
- Delete Configured Pagedestructive
Permanently delete one PageVitals configured page and all of its test results, including historical results. This is irreversible; use only for an explicit request naming the exact website ID and configured-page ID.
- Delete Multistep Testdestructive
Permanently delete one PageVitals multistep test definition. This is irreversible; use only when the user explicitly identifies the exact website ID and test ID.
- Delete Websitedestructive
Permanently delete one PageVitals website and all of its tests, metrics, analytics, and configuration. This is irreversible; use only for an explicit request naming the exact website ID.
- Get Multistep Test
Get one multistep test definition, including its configured steps.
- Get Page Metrics
Get the latest Lighthouse and Chrome UX metrics for one configured page and device.
- Get Page Opportunities
List Lighthouse improvement opportunities for a page/device, or return the full variable-shape details for one opportunity ID.
- Get Page Timeline
Get one historical timeline for a page/device: combined loading metrics, CrUX, network bytes, CPU time, or Google Search performance. Google Search requires that integration on the website.
- Get Test
Get the detailed Lighthouse, timing, resource, budget, and validation summary for one synthetic test. Provider values, nulls, metric scales, and JSON-looking strings are returned unchanged.
- Get Test Report
Get one specialized synthetic-test report: keyed Lighthouse opportunities, the request waterfall, or grouped HTML validation findings. Validation always omits the embedded raw HTML.
- Get Test Series
Get one synthetic test series and its individual tests, statuses, page IDs, device variants, and failure messages.
- List Budgets
List performance budgets, current status, notification settings, and affected pages for a website.
- List Configured Pages
List the raw pages configured for PageVitals monitoring on a website.
- List Multistep Runs
List historical runs for one multistep test, including status, duration, interaction, layout-shift, CPU, transfer-size, and blocking-time metrics.
- List Multistep Tests
List multistep tests configured for a website with recent metrics, state, and success rates. A website with no configured multistep tests returns an empty tests list.
- List Page Metrics
List every configured page/device combination for a website with recent timeline and latest performance metrics.
- List Test Series
List recent synthetic test series for a website, including status and failure counts.
- List Website Opportunities
List Lighthouse improvement opportunities aggregated across a website and the affected pages.
- List Websites
List websites visible to the connected PageVitals API key. Use the returned website IDs with all website-scoped tools.
- Run Multistep Tests
Trigger exactly one named multistep test or intentionally fan out to every multistep test configured for a website. Every triggered run consumes PageVitals test quota and may incur cost. Choosing target='all' can start many jobs, so use it
- Run Test Series
Trigger synthetic tests for selected page/device variants, or for every configured test when pages is omitted. This action consumes PageVitals test quota and may incur cost; call it only when the user explicitly requests a new run.
- Update Budget
Replace a PageVitals performance budget's complete metric threshold and device scope. This may change monitoring alerts or notifications. Read the current budget first, use its exact website and budget IDs, and provide all four desired stat
- Update Configured Page
Update a configured PageVitals page's URL, display alias, or both. This changes persistent monitoring configuration; use the exact page ID from List Configured Pages and provide at least one new value.
- Update Multistep Test
Update a multistep test's alias and device. Both fields are required because PageVitals PUT replacement and partial-update semantics were not safely live-tested; read the current test first when preserving either value.
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Click 'Add Integration' and select PageVitals from the developer tools category. 3. You'll be prompted to paste a PageVitals API key — generate one by logging into your PageVitals dashboard, navigating to Account Settings, and copying the key under API Access. 4. Paste the key into Switchy and click 'Connect'. 5. Switchy will verify the key and display your connected PageVitals account name. 6. Open any Project, type '@PageVitals' in the chat, and ask it to list your monitored websites — if you see results, the connection works. 7. To invoke a tool, address PageVitals directly in a prompt (e.g. '@PageVitals show me the latest Core Web Vitals for example.com'). 8. For destructive operations like deleting a website or budget, you must supply the exact ID in your prompt — PageVitals will confirm before executing.
What teammates see: by default, memories from PageVitals are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Check Site Vitals
@PageVitals show me the current Core Web Vitals for example.com, including LCP, FID, and CLS scores for both mobile and desktop.
Create Performance Budget
@PageVitals create a performance budget for example.com/checkout with LCP under 2.5 seconds and CLS under 0.1 on mobile.
Add Pages to Monitor
@PageVitals add these pages to monitoring for example.com: /pricing, /features, and /contact.
Compare Test Results
@PageVitals compare the last week of test results for example.com/home on mobile versus desktop and highlight any regressions.
Review Multistep Tests
@PageVitals show me all multistep tests for example.com and their most recent results, including any steps that failed.
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@PageVitals show me the Core Web Vitals scores for our homepage and product pages over the last 7 days
Based on PageVitals monitoring data, here's a summary of Core Web Vitals performance: Homepage (example.com): - LCP: 1.8s (Good) — stable across the week - FID: 45ms (Good) — slight improvement on mobile - CLS: 0.08 (Needs Improvement) — spike on Dec 18th Product Pages (/products/*): - LCP: 2.4s (Needs Improvement) — desktop performs better - FID: 120ms (Needs Improvement) — consistent issue - CLS: 0.05 (Good) The homepage CLS spike correlates with a banner deployment. Product pages show consistent interaction delay that may warrant investigation.
This read-heavy example shows PageVitals' strength in historical performance tracking. The MCP requires API key authentication and returns data only for websites already configured in your account. If pages aren't being monitored yet, you'll need to add them first using the Add Configured Pages tool.
@PageVitals create a performance budget for our checkout flow: LCP under 2.5s, FID under 100ms, and CLS under 0.1
Performance budget created successfully for the checkout flow. Budget ID: bgt_9x4k2m Website: example.com Thresholds configured: - Largest Contentful Paint: ≤ 2.5s - First Input Delay: ≤ 100ms - Cumulative Layout Shift: ≤ 0.1 This budget is now active. PageVitals will flag any synthetic test runs or real-user measurements that exceed these thresholds. Depending on your account alerting settings, the website owner may receive notifications when budget violations occur.
This write example demonstrates persistent configuration changes. Creating a budget affects future monitoring behavior and may trigger alerts to your team. The operation consumes account resources and changes how PageVitals evaluates performance, so it should only be invoked when the user explicitly provides threshold values and confirms the action.
@PageVitals analyze our slowest pages from the last month and draft recommendations for the three biggest performance bottlenecks
After reviewing PageVitals data across all monitored pages, here are the three critical bottlenecks: 1. **Third-party script blocking (affects 12 pages)** Problem: Analytics and chat widgets delay FID by 180-240ms on mobile. Recommendation: Defer non-critical scripts using async/defer attributes, or load them after user interaction. 2. **Unoptimized hero images (affects 8 pages)** Problem: Above-the-fold images average 1.2MB, pushing LCP to 3.1s. Recommendation: Implement responsive images with WebP format and lazy-loading for below-the-fold content. 3. **Layout shift from dynamic content (/blog/*)** Problem: CLS averages 0.18 due to ad slots loading after initial render. Recommendation: Reserve explicit space for ad containers with min-height CSS to prevent reflow. These three fixes would improve ~65% of your monitored pages.
This synthesis example pairs PageVitals' monitoring data with AI reasoning to surface actionable insights. The MCP provides raw metrics; the AI interprets patterns and drafts recommendations. Results depend on having sufficient historical data in your PageVitals account — newly added websites may not have enough signal for meaningful analysis.
Use-case deep-dives
When PageVitals makes sense for a product launch sprint
A 6-person team shipping a redesigned marketing site in two weeks needs to catch regressions before customers do. PageVitals wins here because you can add the staging URL, create budgets for Core Web Vitals thresholds, and run multistep tests (checkout flow, signup funnel) without writing Lighthouse scripts. The 28-tool surface means you'll configure once and mostly read metrics after that—perfect for a launch sprint where you check dashboards daily but don't want to babysit CI. If your deploy cadence is slower than weekly, though, you're paying for monitoring you won't use between releases. Best fit: teams that ship user-facing changes at least twice a month and need a single place to track performance drift across 5-15 critical pages.
PageVitals as the source-of-truth for agency deliverables
A 3-person dev shop managing 12 client sites needs to prove they're hitting contractual performance targets (LCP under 2.5s, CLS under 0.1). PageVitals solves this because each client gets a separate website entry, you set budgets that match the SLA, and the API lets you pull monthly reports without manual screenshots. The persistent monitoring means you catch when a client's content team adds an unoptimized hero image—before the client notices. The trade-off: if you're only checking performance at handoff (not ongoing), you don't need 24/7 synthetic tests; a one-time Lighthouse run is cheaper. This MCP pays off when you're contractually on the hook for uptime and performance over months, not just at launch.
When multistep tests catch revenue-killing slowdowns
A 10-person e-commerce team sees conversion drop 8% after a Friday deploy and needs to know if checkout performance regressed. PageVitals' multistep test tool lets you script the add-to-cart → payment → confirmation flow and run it on mobile and desktop profiles, surfacing where the funnel got slow. This is faster than writing Puppeteer scripts and more focused than full-page Lighthouse audits. The limitation: if your checkout has complex auth or requires live payment tokens, the synthetic test setup gets brittle—you'll spend more time maintaining test credentials than analyzing results. Use this when your funnel is mostly public-facing (guest checkout, demo accounts) and you deploy checkout code at least weekly. Skip it if your checkout is behind SSO or you only ship monthly.
Frequently asked
What does the PageVitals MCP do in Switchy?
It monitors website performance and runs synthetic tests directly from your Switchy workspace. You can add pages to monitoring, create performance budgets with alert thresholds, build multistep user flows, and review Core Web Vitals metrics without leaving the AI interface. The MCP handles both configuration (adding sites, setting budgets) and destructive operations (deleting tests, removing pages).
Do I need a PageVitals API key to connect this?
Yes. The MCP uses API key authentication, so you'll need to generate one from your PageVitals account settings before connecting. Anyone on your team with a valid PageVitals API key can connect the integration — no special admin role required in Switchy, though you'll want to control who has keys that can delete websites or historical data.
Can the MCP run performance tests on demand?
No. The MCP configures monitoring and creates test definitions, but it doesn't trigger on-demand synthetic checks. When you add pages or create multistep tests, PageVitals schedules them according to your account's monitoring cadence. If you need instant results, run tests manually in the PageVitals dashboard, then query the MCP for the latest metrics.
How is this different from just using PageVitals directly?
The MCP lets you configure monitoring and review metrics in natural language alongside other work in Switchy. You avoid context-switching to the PageVitals UI for routine tasks like adding pages or checking budget violations. However, for visual reports, waterfall charts, or account-level settings, you'll still need the PageVitals dashboard — the MCP focuses on programmatic configuration and metric retrieval.
Who should connect this integration on our team?
Whoever owns performance monitoring or has a PageVitals API key. Since the MCP can delete websites and wipe historical data, treat the connection like production access. If multiple people need to query metrics, consider a shared API key with read-only permissions (if PageVitals supports scoped keys), or have one person connect it and share Switchy workspace access.