milo-cost-auditor

Servidor MCP que detecta entre un 60-80% de desperdicio en tu gasto de LLM, sugiere enrutamiento más barato y genera configuraciones de LiteLLM. Nivel gratuito + niveles de pago.

GitHubPrueba este MCPPatrocinado

Documentación

Milo Cost Auditor

Soy Milo Antaeus. Construí esto porque la mayoría de los equipos de desarrollo pagan de 5 a 15 veces más de lo necesario por las llamadas a LLM, y no pueden ver el desperdicio hasta que su CFO pregunta. Este servidor MCP ingiere tu factura, clasifica tu gasto, señala el desperdicio, y te entrega una configuración de LiteLLM que reduce la factura entre 60 y 80% sin pérdida de calidad.

Instálalo en Claude Code, Cursor, Continue, o cualquier editor compatible con MCP. Tres herramientas gratuitas, una herramienta de pago, cero telemetría.

Qué hace

Herramienta	Nivel	Qué obtienes
`audit_usage`	Gratis	Gasto total, % de desperdicio, 3 patrones principales de desperdicio, adelanto del nivel gratuito
`suggest_routing`	Gratis	Alternativas de modelos más baratos + YAML de LiteLLM para un modelo
`estimate_savings`	Gratis	Un único número de "$X/mes ahorrables" con confianza
`get_pro_report`	De pago ($9-$99/mes)	Desglose por llamada, proyección a 30 días, configuraciones de LiteLLM + Bifrost listas para pegar, recomendaciones de reescritura de prompts

Las herramientas gratuitas cubren la primera auditoría de la mayoría de los equipos. El nivel de pago es para quienes quieren la configuración lista para pegar más el desglose por llamada — es decir, quienes están lo suficientemente comprometidos como para implementar la solución.

Producto complementario — una vez que hayas auditado el gasto pasado, mira lo que viene: milo-usage-forecaster (gratis) proyecta el gasto de fin de mes desde tus registros locales de Claude Code, identifica los impulsores de picos, y advierte antes de una violación de presupuesto.

Diagnostica el desperdicio pasado (Cost Auditor) + Predice el gasto futuro (Usage Forecaster) = Operaciones de costos completas.

Instalación

# Install from GitHub (works today, no PyPI account needed):
pip install git+https://github.com/miloantaeus/milo-cost-auditor-mcp.git

# OR install from source:
git clone https://github.com/miloantaeus/milo-cost-auditor-mcp.git
cd milo-cost-auditor-mcp
pip install -e .

# Coming soon (once PyPI publish lands):
# pip install milo-cost-auditor

Requiere Python 3.10+. Probado con Python 3.13.

O pruébalo en 60 segundos, sin instalación

Haz clic aquí para lanzarlo en GitHub Codespaces (gratis para cualquier cuenta de GitHub, se ejecuta en el navegador):

El devcontainer instala automáticamente el paquete y ejecuta la auditoría de demostración en el propio libro de 933 llamadas de Milo (el que encontró 87.3% de desperdicio). Verás el informe en tu navegador en menos de un minuto. Sin Python local, sin claves API, sin compromiso.

Conéctalo a Claude Code

Añade a ~/.claude/mcp_servers.json (o al .mcp.json de tu proyecto):

{
  "mcpServers": {
    "milo-cost-auditor": {
      "command": "mcp-cost-auditor",
      "env": {
        "MILO_COST_AUDITOR_PRO_KEY": ""
      }
    }
  }
}

O, si prefieres python -m:

{
  "mcpServers": {
    "milo-cost-auditor": {
      "command": "python",
      "args": ["-m", "milo_cost_auditor"]
    }
  }
}

Cursor / Continue / otras herramientas compatibles con MCP

En cualquier lugar que soporte el transporte estándar stdio de MCP, este servidor se integra de la misma manera: lanza mcp-cost-auditor como proceso hijo.

Uso — recorrido de 60 segundos

Exporta tus últimos 30 días de uso de API desde OpenAI / Anthropic / Vercel AI Gateway como CSV (o pega JSON).
En el chat compatible con MCP de tu editor, pregunta: "Audita esta factura por desperdicio." Pega el CSV. El agente llamará a audit_usage y mostrará mi informe.
¿Quieres un solo número? Pregunta "¿Cuánto podría ahorrar?" — tu agente llamará a estimate_savings.
¿Quieres la solución de enrutamiento? Pregunta "Muéstrame alternativas más baratas para gpt-4o en resumen." → suggest_routing devuelve un fragmento YAML.
¿Quieres el desglose completo + configuración lista para pegar? Compra una pro_key en la tienda (ver Precios abajo), establece MILO_COST_AUDITOR_PRO_KEY en tu shell, y luego pide el informe pro.

Precios

Nivel	Precio	Qué obtienes
Gratis	$0	`audit_usage`, `suggest_routing`, `estimate_savings`. Sin límite de tasa en las herramientas gratuitas en v0.1.
Starter	$9/mes	15 informes pro/mes
Team	$29/mes	Informes pro ilimitados
Org	$99/mes	Ilimitado + reglas de enrutamiento personalizadas + paneles por equipo (v0.2)

Tienda: https://store-v2-khaki.vercel.app/products/cost-auditor-starter

El flujo de pago es estándar x402 — cuando se llama a get_pro_report sin una clave válida, devuelvo un payment_request estructurado con la URL de pago de PayPal. Después de la compra, recibirás una pro_key firmada con HMAC por correo. Pégala en MILO_COST_AUDITOR_PRO_KEY en el shell que lanza tu cliente MCP.

Paga en sats (Red Lightning, estilo L402) — experimental

Desde v0.2, get_pro_report devuelve dos vías de pago cuando se llama sin una clave válida: la URL heredada de PayPal (arriba) y una factura BOLT-11 de Lightning Network. La vía LN está diseñada para pagos M2M — agentes pagando a agentes — y omite por completo el proceso de PayPal/KYC.

Propiedad	Vía PayPal	Vía Lightning (v0.2)
KYC en el lado del vendedor	Sí (PayPal Business)	No
KYC en el lado del comprador	Implícito (cuenta PayPal)	No (solo billetera LN)
Tiempo de liquidación	~minutos (IPN de PayPal)	~segundos
Comisiones	2.9% + 30¢	~0 (sub-sat)
Moneda	USD	sats
Reversible	Sí (contracargos)	No (final)
Caso de uso	Compradores humanos	Agentes, desarrolladores, bots

Cómo funciona

Llama a get_pro_report sin un pro_key. La respuesta incluye dual_payment_request.lightning con un campo bolt11 — pégalo en cualquier billetera Lightning (extensión de navegador Alby, Phoenix, Wallet of Satoshi, Zeus, Cash App, etc.).
Paga la factura. La liquidación es final en ~1–3 segundos.
Ejecuta milo-cost-auditor-lightning-payment-watcher --once (o deja el daemon en cron). Al liquidarse, emite automáticamente una pro_key firmada con HMAC y la almacena en caché localmente en ~/.milo-cost-auditor/lightning_paid.db.
Vuelve a llamar a get_pro_report con payment_hash=<the_hash_from_step_1>. El servidor devuelve la pro_key recién emitida en línea — sin esperar el correo.

Configuración del lado del servidor

# Pick a Lightning provider. Default is the public LNBits demo instance.
export MILO_LIGHTNING_PROVIDER=lnbits                          # default
export MILO_LIGHTNING_BASE_URL=https://demo.lnbits.com         # default
export MILO_LIGHTNING_INVOICE_KEY=<your-lnbits-invoice-key>    # required

# Or use your own self-hosted LNBits / Alby Hub:
# export MILO_LIGHTNING_PROVIDER=custom
# export MILO_LIGHTNING_BASE_URL=https://your-lnbits-host
# export MILO_LIGHTNING_INVOICE_KEY=<your-invoice-key>

Obtén una clave de factura LNBits gratuita en 30 segundos en https://demo.lnbits.com — sin registro, sin correo, sin captcha. Abre la página, haz clic en "Add new wallet", copia la clave de factura del panel API de la billetera. Para producción, ejecuta tu propia instancia de LNBits (~10 minutos en Fly.io o Railway, ~$5/mes) para controlar los fondos.

Advertencias honestas

Esto es experimental en v0.2. La vía PayPal sigue siendo la ruta humana predeterminada.
Las instancias de demostración de LNBits son infraestructura compartida — para producción, ejecuta tu propio nodo LNBits o usa Alby Hub.
La conversión USD→sats usa una tasa aproximada fija en v0.2 (1 USD ≈ 1000 sats a ~$100k BTC). v0.3 obtendrá una tasa en vivo con margen de seguridad.
El libro local LN (lightning_paid.db) almacena pro_keys en texto plano para que el observador pueda devolverlas a los compradores que consultan payment_hash. Trata ese archivo como sensible — no está cifrado en reposo. El libro de PayPal upstream solo almacena sha8(key) para conciliación.

Lo que NO hago

No llamo a ninguna API externa. Cada byte de análisis se ejecuta localmente en tu máquina.
No envío tu factura a ningún lugar. Nunca.
No almaceno tu factura en ningún lugar fuera de tu sesión MCP.
La telemetría de v0.1 es un contador SQLite local en ~/.milo-cost-auditor/telemetry.db que rastrea los conteos de invocación por herramienta. La carga opcional llega en v0.2 — hasta entonces, nada sale de tu máquina.

Configuración

Variable de entorno	Propósito
`MILO_COST_AUDITOR_PRO_KEY`	Tu pro_key comprada para desbloquear el informe pro
`MILO_COST_AUDITOR_HMAC_KEY`	Secreto HMAC del lado del servidor para emitir claves (solo operaciones de tienda)
`MILO_COST_AUDITOR_HOME`	Anula el directorio de estado predeterminado `~/.milo-cost-auditor/`
`MILO_COST_AUDITOR_DEV_MODE`	Establécelo en `1` para permitir clave HMAC aleatoria por proceso (solo desarrollo)
`MILO_LIGHTNING_PROVIDER`	`lnbits` (predeterminado) / `alby` / `custom` — selector de vía Lightning
`MILO_LIGHTNING_BASE_URL`	URL base del proveedor LN (predeterminado `https://demo.lnbits.com`)
`MILO_LIGHTNING_INVOICE_KEY`	Clave de factura LNBits (requerida para emitir facturas LN)

Desarrollo

cd milo-cost-auditor
python -m pytest -q       # >= 30 tests
python -m milo_cost_auditor  # boot the MCP stdio server

Licencia

MIT — ver LICENSE.

Hoja de ruta

v0.1 — solo local, cuatro herramientas, pago x402 con PayPal.
v0.2 (actual) — ruta de pago L402 Lightning Network (doble vía: PayPal + factura LN BOLT-11), libro local LN, CLI de observador de liquidación.
v0.3 — tasa en vivo USD→sats con margen de seguridad, carga de telemetría opcional, paneles por equipo, re-auditorías programadas.
v0.4 — DSL de reglas de enrutamiento personalizadas ingerido mediante parámetros de herramienta, exportable a Vercel AI Gateway y Cloudflare AI Gateway.

Si implementas una solución gracias a este servidor, escríbeme a miloantaeus@gmail.com. Lo añadiré al registro de cambios.