milo-cost-auditor

Servidor MCP que detecta 60-80% de desperdício nos seus gastos com LLM, sugere roteamento mais barato e gera configurações LiteLLM. Camada gratuita + camadas pagas.

GitHubExperimente este MCPPatrocinado

Documentação

Milo Cost Auditor

Eu sou Milo Antaeus. Construí isto porque a maioria dos times de desenvolvimento paga de 5 a 15 vezes mais do que precisam por chamadas de LLM, e eles não conseguem enxergar o desperdício até que o CFO pergunte. Este servidor MCP ingere sua fatura, classifica seus gastos, aponta o desperdício, e entrega uma configuração LiteLLM que reduz a conta em 60-80% sem perda de qualidade.

Instale no Claude Code, Cursor, Continue, ou em qualquer editor compatível com MCP. Três ferramentas gratuitas, uma ferramenta paga, zero telemetria.

O que ele faz

Ferramenta	Nível	O que você recebe
`audit_usage`	Grátis	Gasto total, % de desperdício, 3 principais padrões de desperdício, amostra do nível gratuito
`suggest_routing`	Grátis	Alternativas de modelos mais baratos + YAML LiteLLM para um modelo
`estimate_savings`	Grátis	Um único número "economia de $X/mês" com nível de confiança
`get_pro_report`	Pago ($9-$99/mês)	Detalhamento por chamada, projeção de 30 dias, configurações LiteLLM + Bifrost prontas para colar, recomendações de reescrita de prompts

As ferramentas gratuitas cobrem a primeira auditoria da maioria dos times. O nível pago é para quem quer a configuração pronta para colar além do detalhamento por chamada — ou seja, para quem está levando a sério a implementação da correção.

Produto complementar — depois de auditar os gastos passados, veja o que vem a seguir: milo-usage-forecaster (grátis) projeta o gasto de fim de mês a partir dos seus logs locais do Claude Code, identifica os causadores de picos e alerta antes de estourar o orçamento.

Diagnostique o desperdício passado (Cost Auditor) + Preveja o gasto futuro (Usage Forecaster) = Operação de Custo Completa.

Instalação

# 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

Requer Python 3.10+. Testado com Python 3.13.

Ou experimente em 60 segundos, sem instalação

Clique aqui para iniciar no GitHub Codespaces (grátis para qualquer conta GitHub, roda no navegador):

O devcontainer instala automaticamente o pacote e executa a auditoria de demonstração no próprio ledger de 933 chamadas do Milo (o que encontrou 87,3% de desperdício). Você vê o relatório no seu navegador em menos de um minuto. Sem Python local, sem chaves de API, sem compromisso.

Integre ao Claude Code

Adicione ao ~/.claude/mcp_servers.json (ou ao .mcp.json do seu projeto):

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

Ou, se preferir python -m:

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

Cursor / Continue / outras ferramentas compatíveis com MCP

Em qualquer lugar que suporte o transporte padrão MCP stdio, este servidor se encaixa da mesma forma: inicie mcp-cost-auditor como um processo filho.

Uso — passo a passo em 60 segundos

Exporte seus últimos 30 dias de uso de API da OpenAI / Anthropic / Vercel AI Gateway como CSV (ou cole JSON).
No chat compatível com MCP do seu editor, pergunte: "Audite esta fatura em busca de desperdício." Cole o CSV. O agente chamará audit_usage e exibirá meu relatório.
Quer um único número? Pergunte "Quanto eu poderia economizar?" — seu agente chamará estimate_savings.
Quer a correção de roteamento? Pergunte "Mostre alternativas mais baratas para gpt-4o em sumarização." → suggest_routing retorna um trecho YAML.
Quer o detalhamento completo + configuração pronta para colar? Compre uma pro_key na loja (veja Preços abaixo), defina MILO_COST_AUDITOR_PRO_KEY no seu shell e então peça o relatório pro.

Preços

Nível	Preço	O que você recebe
Grátis	$0	`audit_usage`, `suggest_routing`, `estimate_savings`. Sem limite de taxa nas ferramentas gratuitas na v0.1.
Starter	$9/mês	15 relatórios pro por mês
Time	$29/mês	Relatórios pro ilimitados
Organização	$99/mês	Ilimitado + regras de roteamento personalizadas + painéis por time (v0.2)

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

O fluxo de pagamento é padrão x402 — quando get_pro_report é chamado sem uma chave válida, eu retorno um payment_request estruturado com a URL de checkout do PayPal. Após a compra, você receberá uma pro_key assinada com HMAC por e-mail. Cole-a em MILO_COST_AUDITOR_PRO_KEY no shell que inicia seu cliente MCP.

Pague em sats (Lightning Network, estilo L402) — experimental

Desde a v0.2, get_pro_report retorna duas formas de pagamento quando chamado sem uma chave válida: a URL legada do PayPal (acima) e uma fatura BOLT-11 da Lightning Network. O trilho LN foi projetado para pagamentos M2M — agentes pagando agentes — e elimina completamente o processo de ida e volta do PayPal/KYC.

Propriedade	Trilho PayPal	Trilho Lightning (v0.2)
KYC no lado do vendedor	Sim (PayPal Business)	Não
KYC no lado do comprador	Implícito (conta PayPal)	Não (apenas carteira LN)
Tempo de liquidação	~minutos (IPN do PayPal)	~segundos
Taxas	2,9% + 30¢	~0 (sub-sat)
Moeda	USD	sats
Reversível	Sim (estornos)	Não (final)
Caso de uso	Compradores humanos	Agentes, devs, bots

Como funciona

Chame get_pro_report sem um pro_key. A resposta inclui dual_payment_request.lightning com um campo bolt11 — cole-o em qualquer carteira Lightning (extensão Alby do navegador, Phoenix, Wallet of Satoshi, Zeus, Cash App, etc.).
Pague a fatura. A liquidação é final em ~1–3 segundos.
Execute milo-cost-auditor-lightning-payment-watcher --once (ou deixe o daemon rodando no cron). Na liquidação, ele emite automaticamente uma pro_key assinada com HMAC e a armazena em cache localmente em ~/.milo-cost-auditor/lightning_paid.db.
Chame novamente get_pro_report com payment_hash=<the_hash_from_step_1>. O servidor retorna a pro_key recém-emitida inline — sem ida e volta por e-mail.

Configuração no lado do 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>

Obtenha uma chave de fatura LNBits gratuita em 30 segundos em https://demo.lnbits.com — sem cadastro, sem e-mail, sem captcha. Abra a página, clique em "Add new wallet", copie a chave de fatura do painel de API da carteira. Para produção, execute sua própria instância LNBits (~10 minutos no Fly.io ou Railway, ~$5/mês) para que você controle os fundos.

Ressalvas honestas

Isto é experimental na v0.2. O trilho PayPal continua sendo o caminho padrão para humanos.
Instâncias LNBits de demonstração são infraestrutura compartilhada — para produção, execute seu próprio nó LNBits ou use o Alby Hub.
A conversão USD→sats usa uma taxa aproximada fixa na v0.2 (1 USD ≈ 1000 sats a ~$100k BTC). A v0.3 usará uma taxa ao vivo com margem de segurança.
O ledger LN local (lightning_paid.db) armazena pro_keys brutas para que o observador possa devolvê-las aos compradores que consultam payment_hash. Trate esse arquivo como sensível — ele não é criptografado em repouso. O ledger PayPal upstream armazena apenas sha8(key) para reconciliação.

O que eu NÃO faço

Não chamo nenhuma API externa. Cada byte de análise roda localmente na sua máquina.
Não envio sua fatura para nenhum lugar. Nunca.
Não armazeno sua fatura em nenhum lugar fora da sua sessão MCP.
A telemetria da v0.1 é um contador SQLite local em ~/.milo-cost-auditor/telemetry.db que rastreia contagens de invocação por ferramenta. Upload opcional chega na v0.2 — até lá, nada sai da sua máquina.

Configuração

Variável de ambiente	Finalidade
`MILO_COST_AUDITOR_PRO_KEY`	Sua pro_key comprada para desbloquear o relatório pro
`MILO_COST_AUDITOR_HMAC_KEY`	Segredo HMAC do lado do servidor para emitir chaves (operações da loja apenas)
`MILO_COST_AUDITOR_HOME`	Substitui o diretório de estado padrão `~/.milo-cost-auditor/`
`MILO_COST_AUDITOR_DEV_MODE`	Defina como `1` para permitir chave HMAC aleatória por processo (apenas dev)
`MILO_LIGHTNING_PROVIDER`	`lnbits` (padrão) / `alby` / `custom` — seletor do trilho Lightning
`MILO_LIGHTNING_BASE_URL`	URL base do provedor LN (padrão `https://demo.lnbits.com`)
`MILO_LIGHTNING_INVOICE_KEY`	Chave de fatura LNBits (necessária para emitir faturas LN)

Desenvolvimento

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

Licença

MIT — veja LICENSE.

Roadmap

v0.1 — somente local, quatro ferramentas, pagamento x402 via PayPal.
v0.2 (atual) — caminho de pagamento L402 via Lightning Network (trilho duplo: PayPal + fatura LN BOLT-11), ledger LN local, CLI de observador de liquidação.
v0.3 — taxa ao vivo USD→sats com margem de segurança, upload de telemetria opcional, painéis por time, re-auditorias agendadas.
v0.4 — DSL de regras de roteamento personalizadas ingerida via parâmetros de ferramenta, exportável para Vercel AI Gateway e Cloudflare AI Gateway.

Se você implementar uma correção por causa deste servidor, envie uma mensagem para miloantaeus@gmail.com. Vou adicioná-la ao changelog.