Documentation

Tools exposed by Page Speed Tracker and the limits that apply.

Connect

Server URL: https://speed.tidybutton.com/mcp. Authentication is OAuth with dynamic client registration and an email sign-in code. Claude: Settings, Connectors, Add custom connector.

Tools

`start_speed_batch`

Starts a PageSpeed Insights batch for a list of URLs on mobile, desktop or both.

Inputs: urls (public http or https URLs), strategy (mobile, desktop or both)
Limits: URLs per batch and tests per month by plan. One URL on one strategy is one test; tests that fail on Google's side are not counted.

Test https://example.com/ and https://example.com/pricing on mobile.

`get_speed_batch`

Progress for a batch; runs the next few tests. When done, returns a results table, a report page and a CSV.

Inputs: batch_id
Limits: A few tests per call; each PageSpeed run takes 10 to 30 seconds.

How is speed batch abc going?

`speed_trend`

History of one URL and strategy with the change against the previous run.

Inputs: url, strategy (mobile or desktop), limit
Limits: History window by plan.

Show the speed trend of https://example.com/ on mobile.

`list_speed_batches`

Lists the latest 20 batches for the account.

Inputs: none
Limits: Latest 20.

List my speed batches.

`account_status`

Shows the account email, plan, usage and limits.

Inputs: none
Limits: none

Show my account status.

`activate_license`

Binds a licence key to the account.

Inputs: license_key (string)
Limits: Key must belong to this product.

Activate licence key XXXX-XXXX.

Plan limits

Limit	Free	Pro
URL tests	20	2000
URLs per batch	20	200
months of history	3	12

Network behaviour

Outbound requests use the user agent TidyButtonBot/1.0 (+https://speed.tidybutton.com/bot), time out after 8 seconds and are blocked from private, loopback and link-local addresses.