# metrxbots

> metrxbots is an open-source MCP server for analytics and data. MCP server for tracking AI agent costs, scorecards and ROI from Metrx. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, CLI, Self-hosted, Web
- **Repository:** https://github.com/metrxbots/mcp-server
- **MCP Registry name:** io.github.metrxbots/mcp-server
- **Categories:** [analytics and data](https://ai-powered.com/categories/analytics-and-data), [agent tooling](https://ai-powered.com/categories/agent-tooling)
- **Listing updated:** 2026-11-21

## About

This server connects MCP clients to Metrx, a service that treats each AI agent like an employee: it gets a job contract, a scorecard against that contract, and a P&L showing what it cost and what it produced. Tools use the `metrx_` prefix and carry a required scope (read, write or admin).

A no-key demo mode answers the public desk tools on a synthetic sample organization. Those tools include a workforce review, a job contract drafter, a cost-per-resolution calculator and a vendor bill checker. Signed-in tools cover decision queues, scorecards, job contracts and cost summaries. Job contracts are recorded rather than enforced, so publishing one does not block spend or traffic.

It runs locally over stdio via npm or as a hosted streamable HTTP endpoint. Guided prompts walk through cost analysis, savings discovery and a waste audit that looks for retry storms, oversized contexts, model mismatch, missing caching, idle agents and missing budgets. There is also a Claude Code plugin with six skills.

## Features

- **Demo mode without a key:** Public desk tools answer on a synthetic Northwind sample organization, so you can try it before signing up.
- **Job contracts and scorecards:** Draft, set and read per-agent job contracts and scorecards, with publishing requiring admin scope.
- **Vendor bill reconciliation:** Compare a per-resolution vendor bill against your own records and see matched, disputed and unmatched items.
- **Cost leak scan:** A guided prompt audits agents for retry storms, oversized contexts, missing caching and idle agents.
- **Decision queue:** Review a queue of decisions and record expand, re_specify, combine or retire with a rationale.
- **Stdio and hosted transports:** Run locally through npx or connect to the hosted HTTP endpoint with a bearer key.
- **Scoped API keys and rate limits:** Keys carry read, write or admin scopes, and per-category rate limits return retry-after information.
- **Claude Code plugin:** A desk plugin wraps the workforce tools in six skills for Claude Code.

## Good for

- Track what each AI agent costs and what it produces
- Find wasted spend such as retry storms or missing caching
- Reconcile a per-resolution AI vendor bill against internal records
- Draft job contracts for support triage or SDR qualification agents
- Review a weekly decision queue for an agent workforce

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-server --env METRX_API_KEY='<METRX_API_KEY>' -- npx -y @metrxbot/mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@metrxbot/mcp-server"
      ],
      "env": {
        "METRX_API_KEY": "<METRX_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@metrxbot/mcp-server"
      ],
      "env": {
        "METRX_API_KEY": "<METRX_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@metrxbot/mcp-server"
      ],
      "env": {
        "METRX_API_KEY": "<METRX_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@metrxbot/mcp-server"
      ],
      "env": {
        "METRX_API_KEY": "<METRX_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@metrxbot/mcp-server"
      ],
      "env": {
        "METRX_API_KEY": "<METRX_API_KEY>"
      }
    }
  }
}
```

## Tools

- `metrx_get_workforce_review`: Public tool returning a workforce review, answered on demo data without a key.
- `metrx_draft_job_contract`: Drafts a job contract for one agent from a template.
- `metrx_cost_per_resolution`: Computes price per billed resolution and billed share from vendor-reported counts.
- `metrx_check_vendor_bill`: Reconciles a per-resolution vendor bill against your own records.
- `metrx_get_decision_queue`: Returns the queue of pending decisions for signed-in users.
- `metrx_record_decision`: Records a decision such as expand, re_specify, combine or retire with a rationale.
- `metrx_get_scorecard`: Reads an agent's scorecard.
- `metrx_get_job_contract`: Reads an agent's job contract.
- `metrx_set_job_contract`: Sets or publishes an agent's job contract.
- `metrx_get_cost_summary`: Reads a cost summary for agents.

## FAQ

### Do I need an API key?

Not for the demo. Running with --demo answers the public tools on sample data; otherwise METRX_API_KEY is required.

### How do I run metrxbots?

Use npx @metrxbot/mcp-server over stdio, or connect to the hosted endpoint at https://metrxbot.com/api/mcp.

### Which clients are supported?

Any MCP-compatible client; setup examples cover Claude Desktop, Cursor and Windsurf, and a --setup-claude command writes config for Claude Desktop, Cursor or VS Code.

### What permissions do keys have?

Read tools need read scope, data-changing tools need write, and budget changes, publishing job contracts and creating experiments need admin.

### Is metrxbots open source?

Yes, it is released under the MIT license.

### Is metrxbots free?

Yes. metrxbots is open source, so you can use and self-host it for free.

### How do I add metrxbots to Claude Code?

Run this command in your terminal: claude mcp add mcp-server --env METRX_API_KEY='<METRX_API_KEY>' -- npx -y @metrxbot/mcp-server

### What are the best alternatives to metrxbots?

The closest alternatives to metrxbots are Metrxbot, Agentic Platform, Metabase, APEX AI, LLM, PDF, QR, JSON & Media MCP and AgentBill.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Metrxbot](https://ai-powered.com/mcp/metrxbot): Metrxbot is a freemium MCP server for analytics and data.
- [Agentic Platform](https://ai-powered.com/mcp/agentic-platform): Agentic Platform is a freemium MCP server for agent tooling.
- [Metabase](https://ai-powered.com/mcp/metabase-2): Metabase is an open-source MCP server for analytics and data.
- [APEX AI, LLM, PDF, QR, JSON & Media MCP](https://ai-powered.com/mcp/apex-ai-llm-pdf-qr-json-and-media-mcp): APEX AI, LLM, PDF, QR, JSON & Media MCP is a freemium MCP server for files and documents.
- [AgentBill](https://ai-powered.com/mcp/agentbill): AgentBill is a freemium MCP server for agent tooling.
- [MoltJobs](https://ai-powered.com/mcp/moltjobs): MoltJobs is an open-source MCP server for agent tooling.
- [Agentic Observability MCP](https://ai-powered.com/mcp/agentic-observability-mcp): Agentic Observability MCP is a freemium MCP server for analytics and data.
- [The Context Company](https://ai-powered.com/mcp/the-context-company): The Context Company is an MCP server for agent tooling.

---
Source: https://ai-powered.com/mcp/metrxbots
