Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

Metrxbot

von metrxbotsVersion 0.6.3-1i★ 2 (Sterne des ganzen Repos)iComputer oder CloudOffizielle Website ↗
Name in der Registrycom.metrxbot/mcp-server

So installierst du es

What it does

Manage the AI agents your company employs: workforce review, contracts, bill checks. 42 MCP tools.

  • Connects Computer oder Cloud
  • Account or key Cloud: Sign in to the service when you connect (OAuth) · Local: No key needed
  • Category Dokumente, Tabellen & Büroarbeit

Zusammen nutzen mit

Skills, die der KI diese Art Arbeit beibringen; sie funktionieren zusammen mit diesem

MinerU

Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.

von opendatalab★ 83.9191 Skills

Skill · AnleitungKeine Lizenz angegeben

watermarks-remover

A privacy-first app that strips AI watermarks from content you own.

von guillaumemeyer★ 27.7231 Skills

Skill · Anleitung

obsidian-skills

Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.

von kepano★ 53.104 (whole repo)5 Skills

Skill · Anleitung

Warum es hier steht

Dieser Eintrag steht im Tab „Apps, die sich mit KI verbinden“, der ohne Sterne in dieser Reihenfolge sortiert

1. In Claudes Connector-VerzeichnisNein
2. Vom Team getestetNein
3. Für Nutzer in Thailand geeignetNein
4. Nutzung ohne Sterne33/100Beliebtheit 13 · Aktualität 12 · Antwortet noch 8 · Likes von Nutzern +0
5. Eingetragen am2026-11-15

Likes von Nutzern: 0 · Höchstens 5 Punkte (1 pro Person). Nicht käuflich.

Qualität: 5/5 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte Metrxbot. Folge https://mcp.popnx.com/i/metrxbot-mcp-server.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

5/5 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (metrxbot.com) · ✓ Befehle geprüft am 15. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 2 Min.

Kein Schlüssel, nichts zu installieren · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameMetrxbot
    Remote MCP server URL · Adressehttps://metrxbot.com/api/mcp/connect

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  3. Im Chat einschalten

    +ConnectorsMetrxbot

  4. Ausprobieren

    Nutze Metrxbot und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es Metrxbot nutzt, oder ein Werkzeug von Metrxbot in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit ChatGPT je nach Tarif

Volles MCP: ChatGPT Business, Enterprise oder Edu im Web · Pro: verbindet mit Lese-/Abrufrechten, Werkzeuge, die Daten ändern, gehen evtl. nicht · Plus: in der Doku nicht bestätigt; siehst du auf der Plugins-Seite eine Option für eigene MCP-Server, kannst du es versuchen · nur Web

  1. In ChatGPT im Web die Seite zum Hinzufügen von MCP öffnen

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Name und Adresse eintragen

    Namen eingeben, Adresse unter Connection einfügen, Risikohinweis abhaken und Create as a plugin klicken

    Name · NameMetrxbot
    Connection · Adressehttps://metrxbot.com/api/mcp/connect
  3. Metrxbot im Chat auswählen

    Neuen Chat öffnen und vor dem Tippen Metrxbot aus deinen Plugins wählen

  4. Ausprobieren

    Nutze Metrxbot und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn ChatGPT sagt, dass es Metrxbot nutzt, oder ein Werkzeug von Metrxbot in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von OpenAI abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Claude Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  2. Diesen Befehl einfügen und Enter drücken

    claude mcp add --transport http --scope user metrxbot https://metrxbot.com/api/mcp/connect
  3. /mcp in Claude Code eingeben

    Metrxbot sollte in der Liste als verbunden erscheinen

  4. Ausprobieren

    Nutze Metrxbot und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es Metrxbot nutzt, oder ein Werkzeug von Metrxbot in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in Cursor im Agent-Modus öffnen

  3. Ausprobieren

    Nutze Metrxbot und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es Metrxbot nutzt, oder ein Werkzeug von Metrxbot in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in VS Code im Agent-Modus öffnen

  3. Ausprobieren

    Nutze Metrxbot und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es Metrxbot nutzt, oder ein Werkzeug von Metrxbot in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://metrxbot.com/api/mcp/connect

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die Metrxbot nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das Web

Claude Code

claude mcp add --transport http --scope user metrxbot https://metrxbot.com/api/mcp/connect

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "metrxbot": {
      "url": "https://metrxbot.com/api/mcp/connect"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "metrxbot": {
      "type": "http",
      "url": "https://metrxbot.com/api/mcp/connect"
    }
  }
}

Auf deinem Computer installiert

Claude Code

claude mcp add --scope user metrxbot -- npx -y @metrxbot/mcp-server

Claude Desktop (claude_desktop_config.json)

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

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

{
  "servers": {
    "metrxbot": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@metrxbot/mcp-server"
      ]
    }
  }
}

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

GitHub-Sternei
2 (Sterne des ganzen Repos)
Dieses Repo enthält mehrere MCP-Einträge; die Sterne zählen in Ranglisten nur einmal
Downloads pro Wochei
411/Wo.
Bestätigte Domain
✓ metrxbot.com
Verbindung
Computer oder Cloud
Transport
stdio, streamable-http
Neueste Versioni
0.6.3-1
In der Registry veröffentlichti
15. Nov. 2026
Code zuletzt geänderti
15. Nov. 2026
Zuletzt geprüft
14. Nov. 2026
Entwickler
metrxbots
Pakete
npm: @metrxbot/mcp-server
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Laufen auf deinem Computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Der Server verlangt eine Anmeldung, bevor er seine Tools auflistet.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde über die Domain metrxbot.com bestätigt (die Registry prüft, wem die Domain gehört)

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 4 Tagen

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt MIT

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 224 ms (HTTP 401)

  • ✓ Bestanden

    Anmeldung mit OAuth

    Gibt OAuth-Anmeldung an, damit deine KI-App dich zum Einloggen weiterleiten kann

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Noch nicht geprüft; wir lesen die Tool-Liste, wenn wir den Endpunkt prüfen

Veröffentlichte Schwachstellen (OSV.dev)

Noch nicht geprüft

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/metrxbot-mcp-server.svg)](https://mcp.popnx.com/en/servers/metrxbot-mcp-server)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Dokumente, Tabellen & Büroarbeiti

  • Mehr Sterne als 0 % der anderen 4110 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 88 % der anderen 4110 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 4110 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Metrxbot sicher?

Er hat 5 von 5 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Beides geht: Installiere ihn auf deinem Computer oder verbinde dich mit der Cloud-Version.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 4 Tagen geändert, und die neueste Version (0.6.3-1) kam vor 4 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Puter MCP

Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more

von HeyPuterWeit verbreitet★ 44.198Aktualisiert vor 5 Monaten

Läuft in der Cloud✓ vom Dienst · puter.com

XcodeBuildMCP

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

von getsentryWeit verbreitet↓ 130.486/Wo. geteiltes Paket★ 6585Aktualisiert vor 4 Monaten

Läuft auf deinem Computer✓ vom Dienst · xcodebuildmcp.com

Vexa

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

von Vexa-aiWeit verbreitet★ 2994Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · vexa.ai

Atlassian Rovo MCP Server

Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.

von atlassianWachsend★ 1174Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · atlassian.com

Anki MCP Server

MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.

von ankimcpWachsend↓ 1136/Wo.★ 567Aktualisiert letzten Monat

Läuft auf deinem Computer✓ vom Dienst · ankimcp.ai
Im Vergleich mit ähnlichen
Dieser
Metrxbot
Puter MCPXcodeBuildMCPVexaAtlassian Rovo MCP ServerAnki MCP Server
Läuft woIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine InstallationWird auf deinem Rechner installiertLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationWird auf deinem Rechner installiert
Braucht SchlüsselNeinNeinNeinJaNeinNein
Mit + in Claude hinzufügenNeinNeinNeinNeinJaNein
Basisprüfungen5/54/43/32/44/43/3
LizenzMITAGPL-3.0MITApache-2.0Apache-2.0MIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

Metrx MCP Server

The Model Context Protocol (MCP) server for Metrx: how a company manages the AI agents it employs. Each agent gets a job contract, a scorecard against it, and a P&L: what it cost and what it produced. This server exposes those records as tools that any MCP-compatible client (Claude, GPT, Gemini, custom agents) can call. Version 0.6.3.

This package is the single source for both transports: the npm package you run locally over stdio, and the hosted server at https://metrxbot.com/api/mcp. The public repository at https://github.com/metrxbots/mcp-server is a mirror, synced from the monorepo by packages/mcp-server/scripts/publish-mirror.ts. Contributors open pull requests against the monorepo; issues go to https://github.com/metrxbots/mcp-server/issues.

Quick Start

Three ways in.

1. The demo, no key. The public desk tools answer on the Northwind sample organization, which is synthetic demo data.

npx @metrxbot/mcp-server --demo

2. Interactive login. Opens the browser, saves the key locally, then verifies it.

npx @metrxbot/mcp-server --auth

npx @metrxbot/mcp-server --test

3. A key in the environment.

METRX_API_KEY=sk_live_xxx npx @metrxbot/mcp-server

npx @metrxbot/mcp-server --setup-claude writes the server entry into the Claude Desktop, Cursor or VS Code config for you.

Claude Code plugin

The desk plugin wraps the workforce tool set in six skills.

claude plugin marketplace add metrxbots/mcp-server && claude plugin install metrx-desk@metrxbots

Versions: this server is 0.6.3 (@metrxbot/mcp-server). The desk plugin (metrx-desk) and the TypeScript SDK (@metrxbot/sdk) are separate artefacts with their own version numbers and release schedules; each states its version in its own package.

CommandWhat it doesNeeds a key
/metrx-desk:sample-reviewThe Northwind sample review (synthetic demo data), relayed with every figure's labelNo
/metrx-desk:draft-job-contractDraft a job contract for one agent from a template (support_triage, sdr_qualification, internal_assistant, coding_patch); owner is required; publishing is a separate admin-scope stepNo
/metrx-desk:cost-per-resolutionThe two numbers on a per-resolution AI bill: price per billed resolution and, with total conversations, the billed share. Both are the vendor's own count, labelled vendor-reported, not VerifiedNo
/metrx-desk:check-vendor-billReconcile a per-resolution vendor bill against your own records: matched, disputed, unmatched, uncounted, outside coverage, with the disputed amountNo
/metrx-desk:connect-metrxCreate a key at Settings → Security, set METRX_API_KEY, restart, read your first reviewCreates one
/metrx-desk:weekly-decisionsYour decision queue; record expand, re_specify, combine or retire with a rationaleYes (read; write to record)

The full walkthrough, including the labels every figure carries and the plain HTTP routes, is at https://docs.metrxbot.com/desk.

Tools

The tool registry is published at https://metrxbot.com/.well-known/agent-card.json: names, descriptions, domains, the public subset that answers without a key, and the named tool sets. That file is the authoritative list; this README does not repeat it. Every tool's description ends with the scope it needs (read, write or admin).

Tool names carry the metrx_ prefix. The desk's public tools are metrx_get_workforce_review, metrx_draft_job_contract, metrx_cost_per_resolution and metrx_check_vendor_bill. Signed-in desk tools include metrx_get_decision_queue, metrx_record_decision, metrx_get_scorecard, metrx_get_job_contract and metrx_set_job_contract; cost reads such as metrx_get_cost_summary sit alongside them. A job contract is recorded, not enforced at runtime: publishing one blocks no spend or traffic.

Guided Prompts

MCP prompts are templates that walk a client through a multi-step workflow.

analyze-costs

Fetches the cost summary, lists agents, gets optimization recommendations and returns a prioritized breakdown.

Arguments:

  • period_days (string, optional): number of days to analyze (default: "30")
find-savings

Checks recommendations, runs the cost leak scan and explains each finding in dollars.

Arguments: none

cost-leak-scan

Runs the waste audit: retry storms, oversized contexts, model mismatch, missing caching, idle agents, missing budgets, arbitrage gaps.

Arguments:

  • agent_id (string, optional): scan one agent by UUID, or omit to scan all

Installation

From npm
npm install @metrxbot/mcp-server
Quick Test

Verify your API key and connection:

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

Configuration

Environment Variables
  • `METRX_API_KEY` (optional for --demo, required otherwise): your Metrx API key. Create one at https://app.metrxbot.com/settings/security
  • `METRX_API_URL` (optional): override the API base URL (default: https://app.metrxbot.com/api)
Hosted transport

The same registry is served over streamable HTTP at https://metrxbot.com/api/mcp. Add ?set=workforce to select the desk tool set. The Authorization: Bearer sk_live_... header is optional: without it the public tools answer on the demo (synthetic demo data).

{

"mcpServers": { "metrx": { "type": "http", "url": "https://metrxbot.com/api/mcp?set=workforce", "headers": { "Authorization": "Bearer sk_live_your_key_here" } } } }

MCP Client Setup (stdio)
Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{

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

Cursor

Add to ~/.cursor/mcp.json:

{

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

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{

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

Or run directly:

METRX_API_KEY=sk_live_xxx npx @metrxbot/mcp-server

Rate Limiting

The stdio server enforces per-tool-category rate limits:

CategoryLimit
Dashboard & Agents60 requests/minute
Metrics30 requests/minute
Experiments10 requests/minute
Budgets10 requests/minute
Alerts10 requests/minute
Attribution10 requests/minute
Optimization5 requests/minute
Cost Leak Scan2 requests/5 minutes
Default (other)30 requests/minute

The public desk routes are limited per address at 30 requests per minute; the limit rides in the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers. Hitting a limit returns an error with the retry-after time in seconds.

For high-volume use, contact support@metrxbot.com.

Error Handling

Every refusal carries a class. Over MCP it is a JSON-RPC error with data.class, data.doc and data.user_message; over HTTP it is an RFC 9457 problem body with Retry-After on the retryable classes.

ClassJSON-RPC codeHTTP statusDoc
auth_required-32001401https://docs.metrxbot.com/desk#errors-auth-required
insufficient_scope-32002403https://docs.metrxbot.com/desk#errors-insufficient-scope
rate_limited-32003429https://docs.metrxbot.com/desk#errors-rate-limited
limiter_unavailable-32004503https://docs.metrxbot.com/desk#errors-limiter-unavailable
demo_unavailable-32005503https://docs.metrxbot.com/desk#errors-demo-unavailable
unknown_agent_key-32006404https://docs.metrxbot.com/desk#errors-unknown-agent-key
invalid_params-32602400https://docs.metrxbot.com/desk#errors-invalid-params
transport_error-32007502https://docs.metrxbot.com/desk#errors-transport-error

Server errors from the upstream API (500 and above) are retried with exponential backoff, up to 3 times.

Authentication

Requests to your own organization carry METRX_API_KEY in the Authorization header:

Authorization: Bearer sk_live_xxx

API keys are environment-scoped: sk_live_* for production, sk_test_* for testing, mk_* for machine keys.

Each key also carries scopes. Read tools need read; tools that change data need write; budget changes, publishing a job contract and creating an experiment need admin. An org owner or admin mints keys, including admin-scoped ones, in Settings → Security → API Keys.

Testing

Verify your API key:

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

Run the test suite:

npm run test

Tests cover:

  • Protocol compliance (MCP spec validation)
  • Tool schema and input validation
  • API client retry logic and error handling
  • Rate limiting behavior
  • Output formatting

Troubleshooting

"METRX_API_KEY environment variable is required"

Set the key before starting the server, or run --demo for the public tools:

export METRX_API_KEY=sk_live_your_key

npx @metrxbot/mcp-server

Create a key at https://app.metrxbot.com/settings/security, or run npx @metrxbot/mcp-server --auth.

"Rate limit exceeded"

The error message includes a retry-after time in seconds. Your MCP client should retry after it. For production volume, contact support.

"401 Unauthorized" or auth_required

Your API key is invalid, expired or missing. Create a new one at https://app.metrxbot.com/settings/security.

unknown_agent_key

No agent in your organization has that agent_key. Check the Agents page in the dashboard; the error's suggestions lists close matches when there are any.

Support

  • Docs: https://docs.metrxbot.com (the desk: https://docs.metrxbot.com/desk)
  • API Status: h

Nur der Anfang wird gezeigt; den Rest findest du im Repo