How to connect PageVitals to Grok Bot

Connect Grok Bot to PageVitals MCP. Summarize core web vitals regressions, list failing synthetic website checks, and more using natural language, with authentication handled for you.

PageVitals logoPageVitals
Api Key

PageVitals is a website performance monitoring platform for synthetic tests, real-user monitoring, reports, and performance budgets. Use it to catch slow pages, track Core Web Vitals, and find optimization work before users feel the pain.

28 Tools

Introduction

Grok is xAI's assistant, and its bot builder lets you create a personal agent that holds context, runs skills, and connects to the apps you already use through plugins.

This guide explains how to connect PageVitals to a Grok bot using Composio Connect, which handles OAuth, token refresh, and reliability so you do not have to. You add Composio as a plugin, authenticate once, then ask your bot to work with PageVitals in plain language.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Why use Composio?

Composio exposes 1,700+ apps to your Grok bot through a single connection, so you get:

  • Connect to 1,700+ apps with on-demand tool loading, so you do not fill your context window with unnecessary tool definitions.
  • Use programmatic tool calling through a remote workbench, letting the model write its own code to handle complex tool chaining. This reduces back-and-forth for frequent tool calls.
  • Handle large tool responses outside the model context to keep conversations lean.

Connecting PageVitals to Grok Bot

Once Grok Bot is set up, you connect PageVitals entirely from its interface, and the whole flow takes under a minute.

Set up Grok Bot

Get access. Grok Bot is included with Cursor Ultra, Cursor Premium Teams, and SuperGrok Heavy. Get the desktop app for macOS or Windows from x.ai/bot and sign in. An iPhone companion app is also available, and your bots sync across devices.

Create a bot. Pick a suggested role or define your own, then give it a short name, one primary job, and a short description of how it should work. Focused bots work best, because a clear role gives the bot more useful context over time.

Connect PageVitals

1. Add the Composio plugin

Click the button. The Composio listing on x.ai opens and launches Grok Bot for you. If the app does not open on its own, click Add to Grok Bot.

Add to Grok Bot

Composio for Grok Bot listing on x.ai with the Add to Grok Bot button

Grok Bot opens the Composio plugin, showing its connector and skills. Click Add.

Composio plugin sheet in Grok Bot with the Add button

2. Authenticate

Go to the Installed section and click the Composio entry. You'll see its connector and skills listed.

Installed Composio plugin showing the Authenticate button

Click Authenticate. You'll be taken to the Composio consent screen. Review the access it requests and click Authorize. Composio handles the OAuth handshake for you, so you never touch API keys or tokens.

Composio authorization screen with Authorize and Deny

3. Connect your PageVitals account

Back in the chat, ask your bot to connect to PageVitals or give it any PageVitals task.

For example, ask it to:

  • "Summarize Core Web Vitals regressions"
  • "List failing synthetic website checks"
  • "Review performance budget violations today"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in your Grok bot, and your PageVitals account is ready to use.

What is Grok Bot?

Grok is xAI's assistant, available as a chat interface and a bot builder for creating personal agents that run skills and connect to external apps.

With Composio Connect, your Grok bot can securely access apps like PageVitals through MCP without you sharing account credentials directly with the agent.

What is the PageVitals MCP server, and what's possible with it?

The PageVitals MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your PageVitals account. It provides structured and secure access to your websites, performance metrics, synthetic tests, budgets, and optimization insights, so your agent can monitor page health, run tests, inspect trends, enforce performance targets, and identify improvements on your behalf.

  • Website and page monitoring: Have your agent add websites and pages to monitoring, update their details, list configured pages, or remove sites and pages you no longer track.
  • Performance analysis: Let the agent review Lighthouse and Chrome UX metrics, inspect historical timelines, and compare loading, network, CPU, layout shift, and search performance.
  • Synthetic and multistep testing: Direct your agent to run synthetic test series, create and run multistep tests, review recent runs, and investigate failures or detailed test results.
  • Performance budgets: Instruct your agent to create, review, update, or delete performance budgets and check their current status across affected pages and devices.
  • Optimization and validation insights: Have your agent find Lighthouse improvement opportunities across individual pages or whole websites, then inspect request waterfalls and grouped HTML validation findings.

Way Forward

Now that PageVitals is connected, extend your setup by connecting the other apps you already use every day, so your Grok bot can run true cross-app workflows end to end.

  • Connect Calendar to turn threads into scheduled meetings automatically.
  • Connect Slack or Teams to post summaries, approvals, and alerts where your team works.
  • Connect Notion, Linear, Jira, or Asana to convert requests into tickets, tasks, and docs.
  • Connect Drive, Dropbox, or OneDrive to fetch, file, and share attachments without manual steps.

Start with one workflow you do repeatedly, then keep adding apps as you find new handoffs. With everything behind a single connection, your bot can coordinate multiple tools safely and reliably in one conversation.

TOOLS

Supported Tools

Every PageVitals action and event your agent gets out of the box.

Add Configured Pages

Add one or more explicitly supplied pages to PageVitals monitoring for a website.

Create Budget

Create a persistent PageVitals performance budget for a website.

Create Multistep Test

Create an empty PageVitals multistep test definition with an explicit name and device profile.

Create Website

Add a domain to the PageVitals account and begin managing it.

Delete Budget

Delete one PageVitals performance budget and stop enforcing its threshold.

Delete Configured Page

Permanently delete one PageVitals configured page and all of its test results, including historical results.

Delete Multistep Test

Permanently delete one PageVitals multistep test definition.

Delete Website

Permanently delete one PageVitals website and all of its tests, metrics, analytics, and configuration.

Get Multistep Test

Get one multistep test definition, including its configured steps.

Get Page Metrics

Get the latest Lighthouse and, when available, Chrome UX Report metrics for one configured page on a desktop or mobile 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.

Get Test

Get the detailed Lighthouse, timing, resource, budget, and validation summary for one synthetic test.

Get Test Report

Get one specialized synthetic-test report: keyed Lighthouse opportunities, the request waterfall, or grouped HTML validation findings.

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.

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.

Run Multistep Tests

Trigger exactly one named multistep test or intentionally fan out to every multistep test configured for a website.

Run Test Series

Trigger synthetic tests for selected page/device variants, or for every configured test when pages is omitted.

Update Budget

Replace a PageVitals performance budget's complete metric threshold and device scope.

Update Configured Page

Update a configured PageVitals page's URL, display alias, or both.

Update Multistep Test

Update a multistep test's alias and device.

FAQ

Frequently asked questions

Start with PageVitals.It takes 30 seconds.

Managed auth, hosted MCP servers, and every PageVitals tool your agent needs.Free to start.

Start building