GTmetrix MCP

npx add-mcp 'https://gtmetrix.com/mcp'

GTmetrix MCP

El servidor oficial GTmetrix MCP conecta tu herramienta de IA con GTmetrix para que pueda ejecutar pruebas de rendimiento reales de páginas, leer informes, consultar el historial y gestionar la monitorización, todo desde una instrucción.

No necesitas una cuenta de GTmetrix para probarlo. Conéctate como invitado y empieza a hacer pruebas de inmediato. Inicia sesión para desbloquear más pruebas y funciones.

• URL del servidor: https://gtmetrix.com/mcp
• Transporte: HTTP transmisible (remoto, no hay que instalar nada)
• Autenticación: Invitado (sin iniciar sesión), OAuth o clave de API mediante el encabezado Authorization: Bearer
• Compatible con: Claude, ChatGPT, Codex, Cursor, GitHub Copilot CLI y cualquier cliente compatible con MCP

---

Inicio rápido

Opción 1: OAuth (recomendado)

1. Añade un nuevo servidor MCP remoto o conector personalizado en tu herramienta de IA.
2. Asígnale el nombre GTmetrix y establece la URL en https://gtmetrix.com/mcp.
3. Haz clic en Conectar / Autenticar.

No necesitas una clave de API. También puedes copiar la URL de MCP desde la sección MCP Setup de la página de tu cuenta de GTmetrix.

Usarlo como invitado

No necesitas una cuenta de GTmetrix para empezar. Como invitado, puedes ejecutar pruebas, leer informes y consultar ubicaciones, navegadores y dispositivos, con un número limitado de créditos de invitado.

Cuando agotes los créditos de invitado o quieras usar funciones vinculadas a una cuenta (historial de páginas, monitorización, alertas y etiquetas), pídele a tu IA que inicie sesión. Llamará a gtmetrix_reauthenticate y se abrirá una página de inicio de sesión donde podrás acceder a tu cuenta o crear una cuenta gratuita.

Opción 2: Clave de API

Genera una clave de API en la página de tu cuenta de GTmetrix y añádela a la configuración de tu cliente.

Claude Code

claude mcp add gtmetrix https://gtmetrix.com/mcp --transport http --header "Authorization: Bearer YOUR_API_KEY"

Codex (config.toml)

[mcp_servers.gtmetrix]
url = "https://gtmetrix.com/mcp"

[mcp_servers.gtmetrix.http_headers]
Authorization = "Bearer YOUR_API_KEY"

Configuración JSON (Cursor y otros clientes compatibles con servidores HTTP remotos)

{
  "mcpServers": {
    "gtmetrix": {
      "url": "https://gtmetrix.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

GitHub Copilot CLI (solo OAuth)

/mcp add GTmetrix

Establece Server Type en HTTP, la URL en https://gtmetrix.com/mcp y Tools en *; guarda los cambios y, después, autentícate en el navegador.

Guías paso a paso: Claude · ChatGPT · Codex · Cursor · Copilot CLI

---

Ejemplos de instrucciones

• "Prueba example.com desde Londres y Sídney en un iPhone con LTE y dime si el rendimiento es comparable."
• "Analiza mi informe más reciente de example.com y explica los 3 problemas principales en términos sencillos."
• "Haz una revisión del estado de todas mis páginas monitorizadas con la etiqueta 'client'. Señala las que tengan una calificación inferior a B o un LCP superior a 2s."
• "Compara los informes de esta semana de mi página de pago con los del mes pasado. ¿Ha empeorado algo?"
• "Configura la monitorización diaria de mi página de inicio y avísame si el LCP supera los 2.5 segundos."
• "Corrige el JavaScript que bloquea el renderizado en mi sitio, vuelve a ejecutar GTmetrix y confirma la mejora."

---

Herramientas

Los invitados pueden usar las herramientas de pruebas (excepto gtmetrix_get_report_har) y las herramientas de cuenta y referencia. Para el resto se necesita una cuenta de GTmetrix.

Pruebas

Herramienta	Función
gtmetrix_start_test	Inicia una prueba en una URL. Admite ubicación, navegador, dispositivo simulado, limitación de conexión, AdBlock, vídeo, cookies, autenticación HTTP, listas de URL permitidas o bloqueadas, tamaño de la ventana gráfica y conservación del informe (1, 6, 12 o 24 meses).
gtmetrix_get_test	Comprueba una prueba en curso. Mantiene la conexión abierta en el servidor (hasta 30s por llamada) y devuelve el ID del informe cuando termina.
gtmetrix_get_report	Obtiene un informe finalizado: calificación de GTmetrix, puntuaciones de rendimiento y estructura, Core Web Vitals (LCP, TBT, CLS), los 5 principales problemas de Lighthouse ordenados por impacto, un resumen de recursos y enlaces de descarga del HAR y del JSON completo de Lighthouse.
gtmetrix_get_report_har	Devuelve en línea la cascada del HAR, para clientes que no pueden descargar directamente la URL del HAR. El tamaño está limitado de forma predeterminada.

Historial y páginas

Herramienta	Función
gtmetrix_list_pages	Muestra tus páginas (URL + configuración de prueba) con las puntuaciones más recientes, Web Vitals, estado de monitorización y etiquetas. Filtra por URL, ubicación, navegador, dispositivo, limitación, frecuencia de monitorización, etiquetas y más.
gtmetrix_get_report_history	Obtiene todos los informes de una página, del más reciente al más antiguo, para analizar tendencias y regresiones.

Monitorización y alertas

Herramienta	Función
gtmetrix_set_page_monitoring	Activa (cada hora, día, semana o mes) o desactiva la monitorización de una página.
gtmetrix_get_page_alert_conditions	Lee las condiciones de alerta de una página.
gtmetrix_set_page_alert_conditions	Establece condiciones de alerta para puntuaciones, tiempos (LCP, TTFB, TBT, etc.), tamaño de página, solicitudes o CLS.
gtmetrix_get_page_alert_events	Muestra las alertas que ha activado una página, con enlaces a los informes correspondientes.

Etiquetas

Herramienta	Función
gtmetrix_list_page_tags	Muestra tus etiquetas y cuántas páginas usan cada una.
gtmetrix_save_page_tag	Crea una etiqueta o cambia el nombre o el color de una existente.
gtmetrix_update_page_tags	Añade o quita una etiqueta de hasta 500 páginas a la vez.
gtmetrix_delete_page_tag	Elimina una etiqueta de forma permanente.

Cuenta y referencia

Herramienta	Función
gtmetrix_get_account_status	Muestra tu plan, los créditos de API restantes y la fecha de la próxima recarga (los invitados ven los créditos de invitado restantes).
gtmetrix_get_catalog	Consulta los navegadores, ubicaciones, dispositivos simulados, ajustes preestablecidos de limitación y auditorías de Lighthouse disponibles.
gtmetrix_get_guide	Lee las guías integradas sobre opciones de prueba, análisis de informes, análisis de HAR y errores de prueba.
gtmetrix_reauthenticate	Inicia sesión desde una conexión de invitado o cambia a otra cuenta de GTmetrix.

---

Recursos

El servidor también ofrece sus guías y catálogos como recursos MCP:

• gtmetrix://docs/test-options-guide
• gtmetrix://docs/report-analysis-guide
• gtmetrix://docs/har-analysis-guide
• gtmetrix://docs/general-test-error-guide
• gtmetrix://docs/lighthouse-error-guide
• gtmetrix://catalog/browsers
• gtmetrix://catalog/locations
• gtmetrix://catalog/simulated-devices
• gtmetrix://catalog/throttle-connections
• gtmetrix://catalog/lighthouse-audits

---

Créditos y límites

• Cualquiera puede usar MCP. Los invitados reciben un número limitado de créditos; una cuenta de GTmetrix te da más.
• Las pruebas y otras acciones consumen créditos de API al mismo ritmo que la API de GTmetrix. La grabación de vídeo añade 0.9 créditos por prueba.
• Los créditos disponibles dependen de tu plan. Algunos planes PRO reciben recargas diarias de créditos. Pídele a tu IA que ejecute gtmetrix_get_account_status para consultar tu saldo.
• Pruebas simultáneas: 2 en Basic y 8 en PRO.
• Algunas funciones (más ubicaciones, monitorización cada hora y vídeo en las alertas) dependen de tu plan.

Consulta los planes GTmetrix PRO

---

Preguntas frecuentes

¿Es un chatbot? No. Es una capa de conexión que permite que la herramienta de IA que ya usas acceda a GTmetrix.

¿Necesito una cuenta de GTmetrix? No. Puedes conectarte como invitado y ejecutar pruebas de inmediato. Inicia sesión para desbloquear más pruebas y funciones.

¿Necesito una clave de API? Solo para la configuración manual. Las conexiones OAuth no la necesitan.

¿Por qué no se muestran mis resultados como gráficos? La visualización depende de tu herramienta de IA. Después de obtener un informe, pídele que «visualice estos datos».

¿Puede corregir los problemas por mí? GTmetrix proporciona los datos y diagnósticos. Si tu herramienta de IA también puede editar tu código o CMS, puede aplicar correcciones y volver a ejecutar una prueba para confirmar el resultado.

---

Enlaces

• Presentación de GTmetrix MCP
• Guía de configuración
• Documentación de la API de GTmetrix
• Asistencia