Metrx MCP Server

Rastrea costos de agentes de IA, detecta desperdicios, optimiza modelos y demuestra el ROI. 23 herramientas MCP para seguimiento de costos de LLM, arbitraje de proveedores, control de presupuestos y atribución de ingresos.

GitHub

Prueba este MCPPatrocinado

Documentación

Metrx MCP Server

Tus agentes de IA están desperdiciando dinero. Metrx descubre cuánto, y lo soluciona.

El servidor MCP oficial para Metrx — la Plataforma de Inteligencia de Costos para Agentes de IA. Dale a cualquier agente compatible con MCP (Claude, GPT, Gemini, Cursor, Windsurf) la capacidad de rastrear sus propios costos, detectar desperdicio, optimizar la selección de modelos y demostrar el ROI.

¿Por qué Metrx?

Problema	Lo que hace Metrx
Sin visibilidad del gasto de los agentes	Paneles de costos en tiempo real por agente, modelo y proveedor
Pagando de más por llamadas LLM	El arbitraje de proveedores encuentra modelos más baratos para la misma tarea
Costos descontrolados	Aplicación de presupuestos con pausa automática al alcanzar los límites
Tokens desperdiciados	El escáner de fugas de costos detecta tormentas de reintentos, inflado de contexto y desajuste de modelos
No puedes demostrar el ROI de la IA	La atribución de ingresos vincula las acciones de los agentes con los resultados comerciales

Inicio Rápido

Pruébalo ahora — sin registro

npx @metrxbot/mcp-server --demo

Esto inicia el servidor con datos de muestra para que puedas explorar las 23 herramientas al instante.

Conecta tus datos reales

Opción A — Inicio de sesión interactivo (recomendado):

npx @metrxbot/mcp-server --auth

Abre tu navegador para obtener una API key, la valida y la guarda en ~/.metrxrc para que nunca necesites configurar variables de entorno.

Opción B — Variable de entorno:

METRX_API_KEY=sk_live_your_key_here npx @metrxbot/mcp-server --test

Obtén tu API key gratuita en app.metrxbot.com/sign-up.

Añádelo a tu cliente MCP (Claude Desktop, Cursor, Windsurf)

Si usaste --auth, no se necesita bloque env — la key se lee de ~/.metrxrc automáticamente:

{
  "mcpServers": {
    "metrx": {
      "command": "npx",
      "args": ["@metrxbot/mcp-server"]
    }
  }
}

O pasa la key explícitamente mediante el entorno:

{
  "mcpServers": {
    "metrx": {
      "command": "npx",
      "args": ["@metrxbot/mcp-server"],
      "env": {
        "METRX_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Endpoint HTTP remoto

Para agentes remotos (sin necesidad de instalación local):

POST https://metrxbot.com/api/mcp
Authorization: Bearer sk_live_your_key_here
Content-Type: application/json

Desde npm

npm install @metrxbot/mcp-server

23 herramientas en 10 dominios

Dashboard (3 herramientas)

Herramienta	Descripción
`metrx_get_cost_summary`	Resumen completo de costos — gasto total, número de llamadas, tasas de error y oportunidades de optimización
`metrx_list_agents`	Lista todos los agentes con estado, categoría, métricas de costos e indicadores de salud
`metrx_get_agent_detail`	Información detallada del agente, incluyendo modelo, framework, desglose de costos e historial de rendimiento

Optimización (4 herramientas)

Herramienta	Descripción
`metrx_get_optimization_recommendations`	Recomendaciones de optimización de costos impulsadas por IA por agente o para toda la flota
`metrx_apply_optimization`	Aplica con un clic una recomendación de optimización a un agente
`metrx_route_model`	Recomendación de enrutamiento de modelos para una tarea específica según su complejidad
`metrx_compare_models`	Compara precios y capacidades de modelos LLM entre proveedores

Presupuestos (3 herramientas)

Herramienta	Descripción
`metrx_get_budget_status`	Estado actual de todas las configuraciones de presupuesto con gasto vs. límites
`metrx_set_budget`	Crea o actualiza un presupuesto con aplicación estricta, flexible o de monitoreo
`metrx_update_budget_mode`	Cambia el modo de aplicación de un presupuesto existente o pausa/reanuda

Alertas (3 herramientas)

Herramienta	Descripción
`metrx_get_alerts`	Alertas y notificaciones activas para tu flota de agentes
`metrx_acknowledge_alert`	Marca una o más alertas como leídas/reconocidas
`metrx_get_failure_predictions`	Análisis predictivo de fallos — identifica agentes con probabilidad de fallar antes de que ocurra

Experimentos (3 herramientas)

Herramienta	Descripción
`metrx_create_model_experiment`	Inicia una prueba A/B comparando dos modelos LLM con división de tráfico
`metrx_get_experiment_results`	Significancia estadística, delta de costos y acción recomendada
`metrx_stop_experiment`	Detén un experimento de enrutamiento de modelos en curso y fija al ganador

Detector de Fugas de Costos (1 herramienta)

Herramienta	Descripción
`metrx_run_cost_leak_scan`	Auditoría integral de fugas de costos con 7 verificaciones en toda tu flota de agentes

Atribución (3 herramientas)

Herramienta	Descripción
`metrx_attribute_task`	Vincula las acciones de los agentes con los resultados comerciales para el seguimiento del ROI
`metrx_get_task_roi`	Calcula el retorno de inversión de un agente — costos vs. resultados atribuidos
`metrx_get_attribution_report`	Informe de atribución multi-fuente con puntuaciones de confianza y principales contribuyentes

Configuración de Alertas (1 herramienta)

Herramienta	Descripción
`metrx_configure_alert_threshold`	Configura umbrales de alerta de costos u operativos con email, webhook o pausa automática

Auditoría de ROI (1 herramienta)

Herramienta	Descripción
`metrx_generate_roi_audit`	Informe de auditoría de ROI listo para la junta directiva para tu flota de agentes de IA

Justificación de Actualización (1 herramienta)

Herramienta	Descripción
`metrx_get_upgrade_justification`	Informe de ROI para actualizaciones de plan basado en los patrones de uso actuales

Prompts

Plantillas de prompts predefinidas para flujos de trabajo comunes:

Prompt	Descripción
`analyze-costs`	Resumen integral de costos — desglose de gasto, agentes principales, oportunidades de optimización
`find-savings`	Descubre oportunidades de optimización — degradación de modelos, caché, enrutamiento
`cost-leak-scan`	Escanea patrones de desperdicio — tormentas de reintentos, contextos sobredimensionados, desajuste de modelos

Ejemplos

"¿Cuánto estoy gastando?"

User: What was my AI cost this week?
→ metrx_get_cost_summary(period_days=7)

Total Spend: $234.56 | Calls: 2,450 | Error Rate: 0.2%
├── customer-support: $156.23 (1,800 calls)
└── code-generator: $78.33 (650 calls)

💡 Switch customer-support from GPT-4 to Claude Sonnet: Save $42/week

"Encuéntrame ahorros"

User: Am I overpaying for my agents?
→ metrx_compare_models(models=["gpt-4o", "claude-3-5-sonnet", "gemini-1.5-pro"])

Model Comparison (per 1M tokens):
├── gpt-4o: $2.50 in / $10.00 out
├── claude-3-5-sonnet: $3.00 in / $15.00 out
└── gemini-1.5-pro: $3.50 in / $10.50 out

"Prueba un modelo más barato"

User: Test Claude 3.5 Sonnet against my GPT-4 setup
→ metrx_create_model_experiment(agent_id="agent_123",
    model_a="gpt-4o", model_b="claude-3-5-sonnet-20241022", traffic_split=10)

Experiment started: 90% GPT-4o, 10% Claude 3.5 Sonnet
Check back in 14 days for statistical significance.

Herramienta Complementaria: Detector de Fugas de Costos

Este repositorio también incluye @metrxbot/cost-leak-detector — una CLI gratuita y offline que escanea los registros de tu API LLM en busca de gasto desperdiciado. Sin registro, sin nube, sin que los datos salgan de tu máquina.

npx @metrxbot/cost-leak-detector demo

Ejecuta 7 verificaciones (agentes inactivos, uso excesivo de modelos premium, falta de caché, altas tasas de error, desbordamiento de contexto, ausencia de presupuestos, oportunidades de arbitraje) y te da un informe puntuado en segundos. Consulta la documentación completa.

Configuración

API Key (obligatoria)

El servidor busca tu API key en este orden:

Variable de entorno METRX_API_KEY
Archivo ~/.metrxrc (creado por --auth)

Ejecuta npx @metrxbot/mcp-server --auth para guardar tu key, o configura la variable de entorno directamente.

Variable	Obligatoria	Descripción
`METRX_API_KEY`	Sí*	Tu API key de Metrx (obtén una gratis)
`METRX_API_URL`	No	Sobrescribe la URL base de la API (por defecto: `https://metrxbot.com/api/v1`)

*No obligatoria si has ejecutado --auth — la key se lee de ~/.metrxrc automáticamente.

Flags de CLI

Flag	Descripción
`--demo`	Inicia con datos de muestra — sin necesidad de API key ni registro
`--auth`	Inicio de sesión interactivo — abre el navegador, valida la key, guarda en `~/.metrxrc`
`--test`	Verifica tu API key y conexión

Límite de Peticiones

60 peticiones por minuto por herramienta. Para límites superiores, contacta con support@metrxbot.com.

Desarrollo

git clone https://github.com/metrxbots/mcp-server.git
cd mcp-server
npm install
npm run typecheck
npm test

Contribuciones

Consulta CONTRIBUTING.md para las pautas.

Enlaces

Sitio web: metrxbot.com
Documentación: docs.metrxbot.com
npm: @metrxbot/mcp-server
Smithery: metrxbot/mcp-server
Soporte: support@metrxbot.com

Una Nota sobre el Nombre

El producto es Metrx (metrxbot.com). El scope de npm es @metrxbot y el listado de Smithery es metrxbot/mcp-server. La organización de GitHub es metrxbots (con una s) porque metrxbot ya estaba ocupado en GitHub. Si ves metrxbot vs metrxbots entre plataformas, son el mismo proyecto — solo una restricción de espacio de nombres de GitHub.

Licencia

MIT — consulta LICENSE.

💬 Comentarios

¿Te funcionó Metrx? Nos encantaría saberlo — bueno o malo.

Discusiones de GitHub: Inicia un hilo — preguntas, ideas, lo que estás construyendo
Informes de errores: Abre un issue
Comentarios rápidos: Deja un comentario en nuestro listado de Product Hunt

Si lo instalaste pero encontraste un problema, cuéntanos qué pasó — leemos cada informe.