Connect Gtmetrix to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.
Ask your agent in plain language. Each of these maps to a real tool on the server.
Use the run page speed test tool in Gtmetrix
Use the list locations & browsers tool in Gtmetrix
Use the get report tool in Gtmetrix
Use the retest tool in Gtmetrix
Use the get page tool in Gtmetrix
Use the list pages tool in Gtmetrix
Supported Tools
run_test
Run Page Speed Test
Runs a GTmetrix page speed test on a given URL and optionally waits for the test to complete. Returns the test status and, if completed, the full report with performance metrics. Supports configuring test location, browser, report type, connection throttling, ad blocking, and more.
list_locations_browsers
List Locations & Browsers
Retrieves the available test locations and browsers for GTmetrix performance testing. Use this to discover valid location and browser IDs before running tests. Locations include supported browsers and IP addresses (useful for firewall whitelisting). Browsers include feature support flags.
get_report
Get Report
Retrieves a completed GTmetrix performance report by its report ID or test ID. Returns full performance metrics including grades, scores, Core Web Vitals (LCP, TBT, CLS), timing data, page weight, and links to resources like HAR files, screenshots, and videos. When a test ID is provided, the tool polls for test completion before fetching the report.
retest
Retest
Re-runs a performance test using the original analysis options from an existing page or report. Useful for tracking performance changes over time without reconfiguring test parameters. Optionally waits for completion and returns the new report.
get_page
Get Page
Retrieves a GTmetrix page by ID, including its metadata and optionally its latest report or historical reports list. A page groups all reports that share the same URL and analysis options.
list_pages
List Pages
Lists GTmetrix pages (URL aggregations). Each page groups reports that share the same URL and analysis options, similar to the GTmetrix Dashboard. Supports filtering by URL or monitoring status, sorting, and pagination.
get_account_status
Get Account Status
Retrieves the current GTmetrix account status including API credit balance, next refill time, account type, and feature access flags. Use this to check available credits before running tests.
delete_resource
Delete Page or Report
Deletes a GTmetrix page or report. Deleting a page also removes all its associated reports. This action is permanent and cannot be undone.
get_test
Get Test
Checks the current state of a GTmetrix test without waiting for completion. Returns the report ID when completed, or the failure details when the test failed.
list_tests
List Tests
Lists recent GTmetrix tests with status and report IDs. Supports filtering by state and source, sorting, and pagination to recover queued tests and retrieve completed reports.
list_simulated_devices
List Simulated Devices
Lists GTmetrix simulated-device presets with IDs, viewport dimensions, pixel ratios, and user agents. Pass a device ID to run_test as simulateDevice.
Enable Gtmetrix in Metorial. In your Metorial portal, enable the Gtmetrix MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
Sign in. Select Add and sign in to load Gtmetrix tools.
Enable Gtmetrix in Metorial. In your Metorial portal, enable the Gtmetrix MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom MCP server. On ChatGPT web, open Plugins, select +, then Add custom MCP server.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>), choose OAuth and accept the risk notice.
Create and install the plugin. Select Create as a plugin, install it and sign in to load Gtmetrix tools.
Enable Gtmetrix in Metorial. In your Metorial portal, enable the Gtmetrix MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add Metorial to your MCP config. Use ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
Sign in. Open Customize in the sidebar, find Metorial and sign in to load Gtmetrix tools.
{
"mcpServers":{
"metorial":{
"url":"<your-magic-mcp-url>"
}
}
}
Enable Gtmetrix in Metorial. In your Metorial portal, enable the Gtmetrix MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server over HTTP. Add --scope user to use it in every project.
Sign in. Run /mcp, select Metorial and sign in to load Gtmetrix tools.
claude mcp add --transport http metorial <your-magic-mcp-url>
Enable Gtmetrix in Metorial. In your Metorial portal, enable the Gtmetrix MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server and sign in. The Codex CLI, IDE extension and ChatGPT desktop app share this config.
Check the connection. Type /mcp in Codex to see Metorial and its Gtmetrix tools.
codex mcp add metorial --url <your-magic-mcp-url>
codex mcp login metorial
Run Gtmetrix through the Metorial gateway
One governed layer for every app your agents reach, not a separate connector per tool.
Give Gtmetrix and every other app to your whole team through one MCP gateway, behind your SSO.
Scope which teams and agents can use Gtmetrix tools with role-based access control, and trace every call.
Prefer to run it yourself? Metorial is open source and self-hostable.
Run web page speed tests and retrieve detailed performance reports. Analyze any URL using Lighthouse or legacy PageSpeed/YSlow engines from multiple global server locations and browsers. Configure tests with connection throttling, ad blocking, custom cookies, HTTP authentication, and simulated devices. Retrieve Core Web Vitals, timing metrics, GTmetrix grades, and optimization recommendations. Download report artifacts including HAR files, screenshots, filmstrips, videos, PDF reports, and Lighthouse JSON. Manage pages, view historical reports, retest pages, and query available test locations, browsers, and simulated devices. Check API credit balance and account status.
Frequently asked questions
Common questions about connecting Gtmetrix to AI agents with Metorial.
How many tools does the Gtmetrix MCP server have?
The Gtmetrix MCP server exposes 11 tools, including Run Page Speed Test, List Locations & Browsers, Get Report. Each one is governed and traced through Metorial.
Does the Gtmetrix MCP server support triggers?
Gtmetrix exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
Which AI clients can use the Gtmetrix MCP server?
Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Gtmetrix MCP server through the same Metorial URL.
How do I give only some teams access to Gtmetrix?
Use role-based access control to decide which teams, users, and agents can use Gtmetrix and which of its tools they can call.
Can I self-host the Gtmetrix MCP server?
Yes. Metorial is open source, so you can run the Gtmetrix MCP server yourself or use the hosted gateway.
Connect Gtmetrix to production AI agents
See how Metorial gives your team governed access to Gtmetrix, with tracing and security controls built in.