MCP server

Last updated 2026-08-21

Give any MCP-capable AI assistant (Claude Code, Claude Desktop, and others) direct access to your performance data. Streamable HTTP transport, authenticated with the same API key as the REST API.

Connect a client

claude mcp add rankvitals --transport http https://mcp.rankvitals.io/mcp \
  --header "Authorization: Bearer rv_live_YOUR_KEY"

Try: “Run a mobile speed test on my homepage, then compare it with last week’s results and tell me what regressed.”

Available tools

• run_performance_test — start a Lighthouse test (desktop/mobile)
• run_seo_audit — crawl the site and run SEO + AEO/GEO checks
• get_test_results — status, scores, vitals, findings for a test
• list_recent_tests — recent tests with scores
• get_site_vitals_history — score history for a URL (regression spotting)
• get_fix_recommendations — the AI fix plan for a completed test
• generate_fix_plan — enqueue AI fix-plan generation for a completed test
• get_artifact_links — signed 1-hour download URLs for a test’s HAR, Lighthouse JSON, screenshots and PDF
• compare_tests — score, Core Web Vitals and page-stat deltas between two tests
• get_credits — remaining test credits
• list_monitored_pages — pages monitored on a schedule, with frequency and next run
• create_monitor — schedule recurring tests for a URL
• list_monitors — monitors with schedule, state, and alerts
• set_monitor_enabled — pause or resume a monitor
• delete_monitor — remove a monitor
• create_alert — alert when a metric crosses a threshold
• update_alert — change an alert’s threshold or channels
• delete_alert — remove an alert

Data access and privacy

Every API and MCP request is scoped to the team its key belongs to — a key can never reach another team’s data. Read tools only return data that already exists on your account; write tools start tests and manage your monitors and alerts. The only tools that delete anything are delete_monitor and delete_alert, and neither removes historical test results. Read-only keys cannot call any write tool, and keys may have an optional expiry. Revoking or expiring a key takes effect immediately. What an assistant reads through these tools is also covered by that assistant provider’s own privacy policy. See our privacy policy for sub-processors and retention windows.