# How to connect PageVitals to Grok Bot

```json
{
  "title": "How to connect PageVitals to Grok Bot",
  "toolkit": "PageVitals",
  "toolkit_slug": "page_vitals",
  "framework": "Grok Bot",
  "framework_slug": "grok-bot",
  "url": "https://composio.dev/toolkits/page_vitals/framework/grok-bot",
  "markdown_url": "https://composio.dev/toolkits/page_vitals/framework/grok-bot.md",
  "updated_at": "2026-11-18T06:01:39.767Z"
}
```

## 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](https://docs.composio.dev/toolkits/page_vitals).

## TL;DR

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.

## Connect PageVitals to Grok Bot

### 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](https://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](https://x.ai/bot/plugin/32661537)
Grok Bot opens the Composio plugin, showing its connector and skills. Click Add.
### 2. Authenticate
Go to the Installed section and click the Composio entry. You'll see its connector and skills listed.
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.
### 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.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `PAGE_VITALS_ADD_CONFIGURED_PAGES` | 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 or path and alias. Never discover or scrape pages automatically. |
| `PAGE_VITALS_CREATE_BUDGET` | 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 direction, numeric threshold in the metric's native unit, and device scope. Never infer metric units or operator direction. |
| `PAGE_VITALS_CREATE_MULTISTEP_TEST` | 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. |
| `PAGE_VITALS_CREATE_WEBSITE` | 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. |
| `PAGE_VITALS_DELETE_BUDGET` | Delete Budget | 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. |
| `PAGE_VITALS_DELETE_CONFIGURED_PAGE` | Delete Configured Page | 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. |
| `PAGE_VITALS_DELETE_MULTISTEP_TEST` | Delete Multistep Test | Permanently delete one PageVitals multistep test definition. This is irreversible; use only when the user explicitly identifies the exact website ID and test ID. |
| `PAGE_VITALS_DELETE_WEBSITE` | Delete Website | 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. |
| `PAGE_VITALS_GET_MULTISTEP_TEST` | Get Multistep Test | Get one multistep test definition, including its configured steps. |
| `PAGE_VITALS_GET_PAGE_METRICS` | Get Page Metrics | Get the latest Lighthouse and, when available, Chrome UX Report metrics for one configured page on a desktop or mobile device. |
| `PAGE_VITALS_GET_PAGE_OPPORTUNITIES` | 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 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. |
| `PAGE_VITALS_GET_TEST` | 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. |
| `PAGE_VITALS_GET_TEST_REPORT` | 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. |
| `PAGE_VITALS_GET_TEST_SERIES` | 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 Budgets | List performance budgets, current status, notification settings, and affected pages for a website. |
| `PAGE_VITALS_LIST_CONFIGURED_PAGES` | List Configured Pages | List the raw pages configured for PageVitals monitoring on a website. |
| `PAGE_VITALS_LIST_MULTISTEP_RUNS` | List Multistep Runs | List historical runs for one multistep test, including status, duration, interaction, layout-shift, CPU, transfer-size, and blocking-time metrics. |
| `PAGE_VITALS_LIST_MULTISTEP_TESTS` | 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. |
| `PAGE_VITALS_LIST_PAGE_METRICS` | List Page Metrics | List every configured page/device combination for a website with recent timeline and latest performance metrics. |
| `PAGE_VITALS_LIST_TEST_SERIES` | List Test Series | List recent synthetic test series for a website, including status and failure counts. |
| `PAGE_VITALS_LIST_WEBSITE_OPPORTUNITIES` | List Website Opportunities | List Lighthouse improvement opportunities aggregated across a website and the affected pages. |
| `PAGE_VITALS_LIST_WEBSITES` | List Websites | List websites visible to the connected PageVitals API key. Use the returned website IDs with all website-scoped tools. |
| `PAGE_VITALS_RUN_MULTISTEP_TESTS` | 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 only when the user explicitly requests an all-tests run. |
| `PAGE_VITALS_RUN_TEST_SERIES` | 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. |
| `PAGE_VITALS_UPDATE_BUDGET` | 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 state fields because partial PUT behavior was not safely tested. |
| `PAGE_VITALS_UPDATE_CONFIGURED_PAGE` | 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. |
| `PAGE_VITALS_UPDATE_MULTISTEP_TEST` | 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. |

## Supported Triggers

None listed.

## Creating MCP Server - Stand-alone vs Composio SDK

Once connected, your Grok bot can access the PageVitals MCP server through Composio to run the actions you authorize, using plain language in the chat.

## Complete Code

None listed.

## Conclusion

### 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.

## How to build PageVitals MCP Agent with another framework

None listed.

## Related Toolkits

- [Supabase](https://composio.dev/toolkits/supabase) - Supabase is an open-source backend platform offering scalable Postgres databases, authentication, storage, and real-time APIs. It lets developers build modern apps without managing infrastructure.
- [Codeinterpreter](https://composio.dev/toolkits/codeinterpreter) - Codeinterpreter is a Python-based coding environment with built-in data analysis and visualization. It lets you instantly run scripts, plot results, and prototype solutions inside supported platforms.
- [GitHub](https://composio.dev/toolkits/github) - GitHub is a code hosting platform for version control and collaborative software development. It streamlines project management, code review, and team workflows in one place.
- [1password](https://composio.dev/toolkits/_1password) - 1Password is a password manager and digital vault for storing logins, secrets, notes, and secure documents. It helps individuals and teams protect credentials, share access safely, and reduce password risk.
- [Ably](https://composio.dev/toolkits/ably) - Ably is a real-time messaging platform for live chat and data sync in modern apps. It offers global scale and rock-solid reliability for seamless, instant experiences.
- [Abuselpdb](https://composio.dev/toolkits/abuselpdb) - Abuselpdb is a central database for reporting and checking IPs linked to malicious online activity. Use it to quickly identify and report suspicious or abusive IP addresses.
- [Alchemy](https://composio.dev/toolkits/alchemy) - Alchemy is a blockchain development platform offering APIs and tools for Ethereum apps. It simplifies building and scaling Web3 projects with robust infrastructure.
- [Algolia](https://composio.dev/toolkits/algolia) - Algolia is a hosted search API that powers lightning-fast, relevant search experiences for web and mobile apps. It helps developers deliver instant, typo-tolerant, and scalable search without complex infrastructure.
- [Anakin](https://composio.dev/toolkits/anakin_io) - Anakin is a web automation platform offering scraping, crawling, search, and browser automation. Use it to extract structured data, automate site tasks, and monitor web changes reliably.
- [Anchor browser](https://composio.dev/toolkits/anchor_browser) - Anchor browser is a developer platform for AI-powered web automation. It transforms complex browser actions into easy API endpoints for streamlined web interaction.
- [AnyAPI](https://composio.dev/toolkits/anyapi) - AnyAPI is a marketplace of utility APIs for validation, currency conversion, holidays, documents, and web data. It brings common application workflows together through one practical API platform.
- [Apiflash](https://composio.dev/toolkits/apiflash) - Apiflash is a website screenshot API for programmatically capturing web pages. It delivers high-quality screenshots on demand for automation, monitoring, or reporting.
- [Apiverve](https://composio.dev/toolkits/apiverve) - Apiverve delivers a suite of powerful APIs that simplify integration for developers. It's designed for reliability and scalability so you can build faster, smarter applications without the integration headache.
- [Appcircle](https://composio.dev/toolkits/appcircle) - Appcircle is an enterprise-grade mobile CI/CD platform for building, testing, and publishing mobile apps. It streamlines mobile DevOps so teams ship faster and with more confidence.
- [Appdrag](https://composio.dev/toolkits/appdrag) - Appdrag is a cloud platform for building websites, APIs, and databases with drag-and-drop tools and code editing. It accelerates development and iteration by combining hosting, database management, and low-code features in one place.
- [Appveyor](https://composio.dev/toolkits/appveyor) - AppVeyor is a cloud-based continuous integration service for building, testing, and deploying applications. It helps developers automate and streamline their software delivery pipelines.
- [Authyo](https://composio.dev/toolkits/authyo) - Authyo is a REST API service for passwordless authentication, OTP verification, session management, and transactional notifications. Use it to add secure login flows and user verification without building auth infrastructure from scratch.
- [AWS Marketplace MCP](https://composio.dev/toolkits/aws_marketplace_mcp) - AWS Marketplace MCP provides MCP access to AWS Marketplace's cloud software, data, and services catalog. Use it to discover, compare, and evaluate 30K+ AWS Marketplace listings faster.
- [Azure Monitor Activity Log](https://composio.dev/toolkits/azure_monitor_activity_log) - Azure Monitor Activity Log is Azure's service that records management and control-plane events for a subscription. Use it to audit changes, troubleshoot issues, and track resource operations across your Azure resources.
- [Backendless](https://composio.dev/toolkits/backendless) - Backendless is a backend-as-a-service platform for mobile and web apps, offering database, file storage, user authentication, and APIs. It helps developers ship scalable applications faster without managing server infrastructure.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and PageVitals MCP?

With a standalone PageVitals MCP server, the agents and LLMs can only access a fixed set of PageVitals tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from PageVitals and many other apps based on the task at hand, all through a single MCP endpoint.

### Can I use Tool Router MCP with Grok Bot?

Yes, you can. Grok Bot fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right PageVitals tools.

### Can I manage the permissions and scopes for PageVitals while using Tool Router?

Yes, absolutely. You can configure which PageVitals scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

### How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your PageVitals data and credentials are handled as safely as possible.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)
