Metrx MCP Server

Rastreie custos de agentes de IA, detecte desperdícios, otimize modelos e comprove o ROI. 23 ferramentas MCP para rastreamento de custos de LLM, arbitragem de provedores, controle de orçamento e atribuição de receita.

GitHub

Experimente este MCPPatrocinado

Documentação

Metrx MCP Server

Seus agentes de IA estão desperdiçando dinheiro. A Metrx descobre quanto, e corrige isso.

O servidor MCP oficial para Metrx — a Plataforma de Inteligência de Custo para Agentes de IA. Dê a qualquer agente compatível com MCP (Claude, GPT, Gemini, Cursor, Windsurf) a capacidade de rastrear seus próprios custos, detectar desperdícios, otimizar a seleção de modelos e comprovar ROI.

Por que Metrx?

Problema	O que a Metrx faz
Sem visibilidade nos gastos dos agentes	Painéis de custo em tempo real por agente, modelo e provedor
Pagando a mais por chamadas de LLM	Arbitragem de provedores encontra modelos mais baratos para a mesma tarefa
Custos descontrolados	Aplicação de orçamento com pausa automática quando os limites são atingidos
Tokens desperdiçados	Scanner de vazamento de custo detecta tempestades de tentativas, inchaço de contexto, incompatibilidade de modelo
Não consegue comprovar ROI de IA	Atribuição de receita vincula ações do agente a resultados de negócio

Início Rápido

Experimente agora — sem necessidade de cadastro

npx @metrxbot/mcp-server --demo

Isso inicia o servidor com dados de exemplo para que você possa explorar todas as 23 ferramentas instantaneamente.

Conecte seus dados reais

Opção A — Login interativo (recomendado):

npx @metrxbot/mcp-server --auth

Abre seu navegador para obter uma chave de API, valida-a e salva em ~/.metrxrc para que você nunca precise definir variáveis de ambiente.

Opção B — Variável de ambiente:

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

Obtenha sua chave de API gratuita em app.metrxbot.com/sign-up.

Adicione ao seu cliente MCP (Claude Desktop, Cursor, Windsurf)

Se você usou --auth, nenhum bloco env é necessário — a chave é lida automaticamente de ~/.metrxrc:

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

Ou passe a chave explicitamente via ambiente:

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

Endpoint HTTP remoto

Para agentes remotos (sem necessidade de instalação local):

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

Via npm

npm install @metrxbot/mcp-server

23 Ferramentas em 10 Domínios

Painel (3 ferramentas)

Ferramenta	Descrição
`metrx_get_cost_summary`	Resumo abrangente de custos — gasto total, contagem de chamadas, taxas de erro e oportunidades de otimização
`metrx_list_agents`	Lista todos os agentes com status, categoria, métricas de custo e indicadores de saúde
`metrx_get_agent_detail`	Informações detalhadas do agente, incluindo modelo, framework, detalhamento de custos e histórico de desempenho

Otimização (4 ferramentas)

Ferramenta	Descrição
`metrx_get_optimization_recommendations`	Recomendações de otimização de custos com IA por agente ou para toda a frota
`metrx_apply_optimization`	Aplicar com um clique uma recomendação de otimização a um agente
`metrx_route_model`	Recomendação de roteamento de modelo para uma tarefa específica com base na complexidade
`metrx_compare_models`	Compare preços e capacidades de modelos LLM entre provedores

Orçamentos (3 ferramentas)

Ferramenta	Descrição
`metrx_get_budget_status`	Status atual de todas as configurações de orçamento com gastos vs. limites
`metrx_set_budget`	Criar ou atualizar um orçamento com aplicação rígida, flexível ou monitoramento
`metrx_update_budget_mode`	Alterar o modo de aplicação de um orçamento existente ou pausar/retomar

Alertas (3 ferramentas)

Ferramenta	Descrição
`metrx_get_alerts`	Alertas ativos e notificações para sua frota de agentes
`metrx_acknowledge_alert`	Marcar um ou mais alertas como lidos/reconhecidos
`metrx_get_failure_predictions`	Análise preditiva de falhas — identifique agentes com probabilidade de falhar antes que isso aconteça

Experimentos (3 ferramentas)

Ferramenta	Descrição
`metrx_create_model_experiment`	Iniciar um teste A/B comparando dois modelos LLM com divisão de tráfego
`metrx_get_experiment_results`	Significância estatística, delta de custo e ação recomendada
`metrx_stop_experiment`	Parar um experimento de roteamento de modelo em execução e fixar o vencedor

Detector de Vazamento de Custo (1 ferramenta)

Ferramenta	Descrição
`metrx_run_cost_leak_scan`	Auditoria abrangente de vazamento de custo com 7 verificações em toda a sua frota de agentes

Atribuição (3 ferramentas)

Ferramenta	Descrição
`metrx_attribute_task`	Vincular ações do agente a resultados de negócio para rastreamento de ROI
`metrx_get_task_roi`	Calcular retorno sobre investimento para um agente — custos vs. resultados atribuídos
`metrx_get_attribution_report`	Relatório de atribuição multi-fonte com pontuações de confiança e principais contribuidores

Configuração de Alertas (1 ferramenta)

Ferramenta	Descrição
`metrx_configure_alert_threshold`	Definir limites de alerta de custo ou operacionais com e-mail, webhook ou pausa automática

Auditoria de ROI (1 ferramenta)

Ferramenta	Descrição
`metrx_generate_roi_audit`	Relatório de auditoria de ROI pronto para o conselho para sua frota de agentes de IA

Justificativa de Upgrade (1 ferramenta)

Ferramenta	Descrição
`metrx_get_upgrade_justification`	Relatório de ROI para upgrades de nível com base nos padrões de uso atuais

Prompts

Modelos de prompt pré-construídos para fluxos de trabalho comuns:

Prompt	Descrição
`analyze-costs`	Visão geral abrangente de custos — detalhamento de gastos, principais agentes, oportunidades de otimização
`find-savings`	Descubra oportunidades de otimização — downgrades de modelo, cache, roteamento
`cost-leak-scan`	Verifique padrões de desperdício — tempestades de tentativas, contextos superdimensionados, incompatibilidade de modelo

Exemplos

"Quanto estou 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

"Encontre economias para mim"

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

"Teste um modelo mais 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.

Ferramenta Complementar: Detector de Vazamento de Custo

Este repositório também inclui @metrxbot/cost-leak-detector — um CLI gratuito e offline que verifica seus logs de API LLM em busca de gastos desperdiçados. Sem cadastro, sem nuvem, nenhum dado sai da sua máquina.

npx @metrxbot/cost-leak-detector demo

Ele executa 7 verificações (agentes ociosos, uso excessivo de modelos premium, falta de cache, altas taxas de erro, estouro de contexto, ausência de orçamentos, oportunidades de arbitragem) e fornece um relatório pontuado em segundos. Veja a documentação completa.

Configuração

Chave de API (obrigatória)

O servidor procura sua chave de API nesta ordem:

Variável de ambiente METRX_API_KEY
Arquivo ~/.metrxrc (criado por --auth)

Execute npx @metrxbot/mcp-server --auth para salvar sua chave, ou defina a variável de ambiente diretamente.

Variável	Obrigatória	Descrição
`METRX_API_KEY`	Sim*	Sua chave de API Metrx (obtenha uma gratuitamente)
`METRX_API_URL`	Não	Substituir URL base da API (padrão: `https://metrxbot.com/api/v1`)

*Não é obrigatória se você executou --auth — a chave é lida automaticamente de ~/.metrxrc.

Flags de CLI

Flag	Descrição
`--demo`	Iniciar com dados de exemplo — sem chave de API ou cadastro
`--auth`	Login interativo — abre o navegador, valida a chave, salva em `~/.metrxrc`
`--test`	Verificar sua chave de API e conexão

Limite de Taxa

60 requisições por minuto por ferramenta. Para limites maiores, entre em contato com support@metrxbot.com.

Desenvolvimento

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

Contribuindo

Veja CONTRIBUTING.md para diretrizes.

Uma Nota sobre Nomenclatura

O produto é Metrx (metrxbot.com). O escopo npm é @metrxbot e a listagem no Smithery é metrxbot/mcp-server. A organização no GitHub é metrxbots (com s) porque metrxbot já estava ocupado no GitHub. Se você vir metrxbot vs metrxbots em diferentes plataformas, são o mesmo projeto — apenas uma restrição de namespace do GitHub.

Licença

MIT — veja LICENSE.

💬 Feedback

A Metrx funcionou para você? Adoraríamos saber — bom ou ruim.

Discussões no GitHub: Inicie um tópico — perguntas, ideias, o que você está construindo
Relatórios de bugs: Abra uma issue
Feedback rápido: Deixe um comentário na nossa listagem no Product Hunt

Se você instalou mas encontrou um problema, conte-nos o que aconteceu — lemos todos os relatos.

Metrx MCP Server

Documentação

Metrx MCP Server

Por que Metrx?

Início Rápido

Experimente agora — sem necessidade de cadastro

Conecte seus dados reais

Adicione ao seu cliente MCP (Claude Desktop, Cursor, Windsurf)

Endpoint HTTP remoto

Via npm

23 Ferramentas em 10 Domínios

Painel (3 ferramentas)

Otimização (4 ferramentas)

Orçamentos (3 ferramentas)

Alertas (3 ferramentas)

Experimentos (3 ferramentas)

Detector de Vazamento de Custo (1 ferramenta)

Atribuição (3 ferramentas)

Configuração de Alertas (1 ferramenta)

Auditoria de ROI (1 ferramenta)

Justificativa de Upgrade (1 ferramenta)

Prompts

Exemplos

"Quanto estou gastando?"

"Encontre economias para mim"

"Teste um modelo mais barato"

Ferramenta Complementar: Detector de Vazamento de Custo

Configuração

Chave de API (obrigatória)

Flags de CLI

Limite de Taxa

Desenvolvimento

Contribuindo

Links

Uma Nota sobre Nomenclatura

Licença

💬 Feedback