# GTmetrix — MCP server on mcp.ai
> Connect your GTmetrix account and use 20 tools for developer tools straight from your AI agent. Connect with your own API key. GTmetrix is a performance testing and monitoring tool that analyzes website speed, provides detailed performance reports, and helps optimize web applications for better user experience.

By: mcp.ai · official
Page: https://mcp.ai/gtmetrix

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_gtmetrix?ms=1787291340000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/gtmetrix/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/gtmetrix/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/gtmetrix/skill.md
Postman collection (v2.1): https://mcp.ai/gtmetrix/postman.json

## Tools
- gtmetrix_delete_page(page_id: string) — Tool to delete a specific page in GTmetrix. Use when you need to permanently remove a page resource.
- gtmetrix_delete_report(report_id: string) — Tool to delete a GTmetrix report. Use when you need to remove an existing performance report from GTmetrix.
- gtmetrix_get_browser(browser_id: string) — Tool to retrieve browser details from GTmetrix. Use when you need to get information about a specific browser including name, platform, supported features, and testing capabilities.
- gtmetrix_get_browsers() — Tool to retrieve the list of available browsers for GTmetrix performance tests. Use when you need to see which browsers are available and their testing capabilities.
- gtmetrix_get_location(location_id: string) — Tool to retrieve location details from GTmetrix. Use when you need to get information about a specific GTmetrix test location including name, region, browser support, IP addresses, and access permissi
- gtmetrix_get_locations() — Tool to retrieve the list of available GTmetrix test locations. Use when you need to see which locations are available for testing and their details including supported browsers and access status.
- gtmetrix_get_page(page_id: string) — Tool to retrieve page details from the user's GTmetrix account. Use when you need to get comprehensive page information including URL, testing configuration, and monitoring frequency.
- gtmetrix_get_page_latest_report(page_id: string) — Tool to retrieve the most recent test report for a monitored page in GTmetrix. Use when you need to get the latest performance metrics and timing data for a specific page.
- gtmetrix_get_page_reports(sort?: string, filter?: string, page_id: string, page_size?: integer, page_number?: integer) — Tool to retrieve the report list associated with a monitored page in GTmetrix. Use when you need to access historical performance data for a specific page. Supports pagination, sorting, and filtering.
- gtmetrix_get_pages(sort?: string, filter?: string, page_size?: integer, page_number?: integer) — Tool to retrieve the page list from your GTmetrix account. Returns a paginated collection of monitored pages with their configurations and latest report information. Use when you need to view all moni
- gtmetrix_get_report(report_id: string) — Tool to retrieve a GTmetrix test report by its identifier. Use when you need to get comprehensive performance metrics, timing data, and links to resources for a specific report.
- gtmetrix_get_report_resource(report_id: string, resource_name: string) — Tool to get a report resource such as screenshot, HAR file, video, PDF, or Lighthouse JSON. Use when you need to download specific report artifacts that require API authentication.
- gtmetrix_get_simulated_device(simulated_device_id: string) — Tool to retrieve simulated device details. Use when you need information about a specific simulated device including its name, category, manufacturer, user agent, screen dimensions, and pixel ratio.
- gtmetrix_get_simulated_devices() — Tool to retrieve the list of simulated devices available in GTmetrix. Use when you need to see available device profiles for testing.
- gtmetrix_get_status() — Tool to retrieve the current API account state and remaining credits. Use to check available API credits, refill schedule, and account features.
- gtmetrix_get_test(test_id: string) — Tool to retrieve test details for a specific GTMetrix test. Use when you need to check the status, configuration, or results of a previously initiated test.
- gtmetrix_get_tests(sort?: string, page_size?: integer, page_number?: integer, filter_state?: string, filter_browser?: string, filter_created?: string, filter_started?: string, filter_finished?: string, filter_location?: string) — Tool to retrieve the test list from your GTmetrix account with pagination and filtering support. Use when you need to view tests with their state, timestamps, and configuration details.
- gtmetrix_retest_page(page_id: string) — Tool to initiate a retest of a GTmetrix page with same parameters. Use when you need to create a new test using the same parameters as the most recent report for this page.
- gtmetrix_retest_report(report_id: string) — Tool to initiate a retest of a completed GTmetrix report with same parameters. Use when you need to rerun a test using the exact same analysis parameters as the original test.
- gtmetrix_start_test(dns?: string[], url: string, video?: integer, report?: string, adblock?: integer, browser?: string, cookies?: string[], location?: string, throttle?: string, allow_url?: string[], block_url?: string[], retention?: integer, user_agent?: string, stop_onload?: integer, browser_dppx?: number, browser_width?: integer, browser_height?: integer, browser_rotate?: integer, simulate_device?: string, httpauth_password?: string, httpauth_username?: string) — Tool to start a new GTmetrix test for a specified URL. Use when you need to analyze website performance with configurable options like location, browser, and throttling.

## Example prompts
- "What can I do in GTmetrix?"
- "Show me a summary of my GTmetrix account"

## Links
Docs: https://mcp.ai/docs/mcps/gtmetrix
Website: https://mcp.ai/mcps/gtmetrix