Metrxbot — Claude Code MCP server: what it does, how to install
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.
MIT ★ 2 updated 2026-11-15
claude mcp add --transport http mcp-server https://metrxbot.com/api/mcp/connectWhat Metrxbot 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.
What it helps with
- 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 for the agent
- 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
How to install Metrxbot
1Platform CLI: remote server
claude mcp add --transport http mcp-server https://metrxbot.com/api/mcp/connect2Platform CLI
claude mcp add metrxbot -- npx -y @metrxbot/mcp-server1Platform CLI: remote server
codex mcp add metrxbot --url https://metrxbot.com/api/mcp/connect2Platform CLI
codex mcp add metrxbot -- npx -y @metrxbot/mcp-serverConfig file
{
"mcpServers": {
"metrxbot": {
"url": "https://metrxbot.com/api/mcp/connect"
}
}
}{
"mcpServers": {
"metrxbot": {
"command": "npx",
"args": [
"-y",
"@metrxbot/mcp-server"
]
}
}
}Config file
{
"servers": {
"metrxbot": {
"type": "http",
"url": "https://metrxbot.com/api/mcp/connect"
}
}
}{
"servers": {
"metrxbot": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@metrxbot/mcp-server"
]
}
}
}1Platform CLI: remote server
gemini mcp add -t http metrxbot https://metrxbot.com/api/mcp/connect2Platform CLI
gemini mcp add metrxbot npx -y @metrxbot/mcp-serverStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Metrxbot
How to install Metrxbot in Claude Code?
To connect via HTTP, run claude mcp add --transport http metrxbot https://metrxbot.com/api/mcp/connect. For local stdio execution via npm, run claude mcp add metrxbot -- npx -y @metrxbot/mcp-server.
What does Metrxbot do?
It provides MCP tools to track enterprise AI agents, their operational contracts, scorecards, and financial metrics. The server also analyzes token waste and flags billing discrepancies from model vendors.
What is required to run Metrxbot?
Demo mode works without credentials on synthetic Northwind data. Production workforce analysis requires a METRX_API_KEY environment variable from Metrx settings.