# Metrxbot

Metrxbot is a Claude Code MCP server that links AI agent scorecards, contracts, and cost metrics to your environment. It audits token waste, drafts role contracts, and reconciles provider bills.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2 repo stars
- Author: metrxbots
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/metrxbots/mcp-server
- Updated: 2026-11-15
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/metrxbot

## What it does

The server exposes 42 tools for monitoring an organization's deployed AI agents. Each agent profile tracks job specifications, performance evaluations, and financial profit-and-loss balances. Job contracts are cataloged without blocking runtime execution or spending.

Connection runs either over streamable HTTP at `https://metrxbot.com/api/mcp` or locally via stdio with `@metrxbot/mcp-server`. A built-in demo mode inspects synthetic Northwind organization figures without credentials. Live company data requires a `METRX_API_KEY` token generated in Metrx security settings.

Built-in guided workflows such as `analyze-costs`, `find-savings`, and `cost-leak-scan` pinpoint retry cascades, context bloat, absent caching, and idle agents with dollar-denominated loss calculations.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://metrxbot.com/api/mcp/connect`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp-server https://metrxbot.com/api/mcp/connect
```

2. **Platform CLI**
```bash
claude mcp add metrxbot -- npx -y @metrxbot/mcp-server
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add metrxbot --url https://metrxbot.com/api/mcp/connect
```

2. **Platform CLI**
```bash
codex mcp add metrxbot -- npx -y @metrxbot/mcp-server
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "metrxbot": {
            "url": "https://metrxbot.com/api/mcp/connect"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "metrxbot": {
            "command": "npx",
            "args": [
                "-y",
                "@metrxbot/mcp-server"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "metrxbot": {
            "type": "http",
            "url": "https://metrxbot.com/api/mcp/connect"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "metrxbot": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@metrxbot/mcp-server"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http metrxbot https://metrxbot.com/api/mcp/connect
```

2. **Platform CLI**
```bash
gemini mcp add metrxbot npx -y @metrxbot/mcp-server
```

## When to use it
- reconcile resolution vendor bills against internal logs
- draft task contracts for automated agents
- audit token leakage and oversized contexts
- inspect AI workforce spending and scorecards

## Example prompts
- Run a cost leak scan across all active AI agents
- Reconcile our support resolution bill with vendor figures
- Fetch the 30-day AI agent cost summary

## Similar
- [aws-billing-and-cost-management](https://affpapa.org/en/nevibecode/skills/aws-billing-and-cost-management.md) — skill · 10300 installs
- [AWS Billing and Cost Management](https://affpapa.org/en/nevibecode/mcp/aws-billing-and-cost-management.md) — MCP server · ★ 9939 repo stars
- [cloud-finops](https://affpapa.org/en/nevibecode/plugins/cloud-finops.md) — plugin · ★ 75 repo stars
- [cost-optimization](https://affpapa.org/en/nevibecode/skills/rampstackco-cost-optimization.md) — skill · 283 installs
- [aws-cost-optimization](https://affpapa.org/en/nevibecode/skills/ahmedasmar-aws-cost-optimization.md) — skill · 222 installs
- [huawei-cloud-billing-scout](https://affpapa.org/en/nevibecode/skills/huawei-cloud-billing-scout.md) — skill · 18500 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
