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 Anmelden

BotArmor: LLM red teaming for chatbots

von sidorenkav-collabVersion 0.1.2i★ 0iComputer oder CloudOffizielle Website ↗
Name in der Registryio.github.sidorenkav-collab/botarmor

So installierst du es

Was es kann

LLM red teaming and prompt injection testing for chatbots and AI agents: A-F grade, prompt fixes.

Originaltext des Herstellers

  • Verbindung Computer oder Cloud
  • Konto oder Schlüssel Cloud: Beim Verbinden beim Dienst anmelden (OAuth) · Lokal: Braucht BOTARMOR_API_KEY
  • Kategorie Suche & KI-Gedächtnis

Zusammen nutzen mit

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

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

von google-research★ 35.6421 Skills

Skill · Anleitung

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

von BigBodyCobain★ 11.6081 Skills

Skill · Anleitung

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

von gosom★ 8.2561 Skills

Skill · Anleitung

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit0/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch8/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert20/100

Qualität: 5/5 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

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

Mit einem Satz von deiner KI installieren lassen

Installiere bitte BotArmor: LLM red teaming for chatbots. Folge https://mcp.popnx.com/i/sidorenkav-collab-botarmor.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 (app.botarmor.eu) · ✓ Befehle geprüft am 20. 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 · NameBotArmor: LLM red teaming for chatbots
    Remote MCP server URL · Adressehttps://app.botarmor.eu/mcp

    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

    +ConnectorsBotArmor: LLM red teaming for chatbots

  4. Ausprobieren

    Nutze BotArmor: LLM red teaming for chatbots und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es BotArmor: LLM red teaming for chatbots nutzt, oder ein Werkzeug von BotArmor: LLM red teaming for chatbots 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 · NameBotArmor: LLM red teaming for chatbots
    Connection · Adressehttps://app.botarmor.eu/mcp
  3. BotArmor: LLM red teaming for chatbots im Chat auswählen

    Neuen Chat öffnen und vor dem Tippen BotArmor: LLM red teaming for chatbots aus deinen Plugins wählen

  4. Ausprobieren

    Nutze BotArmor: LLM red teaming for chatbots und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn ChatGPT sagt, dass es BotArmor: LLM red teaming for chatbots nutzt, oder ein Werkzeug von BotArmor: LLM red teaming for chatbots 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 botarmor https://app.botarmor.eu/mcp
  3. /mcp in Claude Code eingeben

    BotArmor: LLM red teaming for chatbots sollte in der Liste als verbunden erscheinen

  4. Ausprobieren

    Nutze BotArmor: LLM red teaming for chatbots und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es BotArmor: LLM red teaming for chatbots nutzt, oder ein Werkzeug von BotArmor: LLM red teaming for chatbots 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 BotArmor: LLM red teaming for chatbots und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es BotArmor: LLM red teaming for chatbots nutzt, oder ein Werkzeug von BotArmor: LLM red teaming for chatbots 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 BotArmor: LLM red teaming for chatbots und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es BotArmor: LLM red teaming for chatbots nutzt, oder ein Werkzeug von BotArmor: LLM red teaming for chatbots 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://app.botarmor.eu/mcp

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

Hängst du fest? Frag Leute, die BotArmor: LLM red teaming for chatbots nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das Web

Claude Code

claude mcp add --transport http --scope user botarmor https://app.botarmor.eu/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "botarmor": {
      "url": "https://app.botarmor.eu/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "botarmor": {
      "type": "http",
      "url": "https://app.botarmor.eu/mcp"
    }
  }
}

Auf deinem Computer installiert

Claude Code

claude mcp add --scope user botarmor --env BOTARMOR_API_KEY=your-value -- npx -y @botarmor/mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "botarmor": {
      "command": "npx",
      "args": [
        "-y",
        "@botarmor/mcp"
      ],
      "env": {
        "BOTARMOR_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "botarmor": {
      "command": "npx",
      "args": [
        "-y",
        "@botarmor/mcp"
      ],
      "env": {
        "BOTARMOR_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "botarmor": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@botarmor/mcp"
      ],
      "env": {
        "BOTARMOR_API_KEY": "your-value"
      }
    }
  }
}

Werte, die du selbst einträgst

  • BOTARMOR_API_KEY geheim erforderlich env
    BotArmor-API-Schlüssel (ba_live_...) aus dem Kundenbereich, Registerkarte API.
    Englisches Original anzeigenBotArmor API key (ba_live_...), from the client area, tab API

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

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

Auf einen Blick

Downloads pro Wochei
23/Wo.
Verbindung
Computer oder Cloud
Transport
stdio, streamable-http
Neueste Versioni
0.1.2
In der Registry veröffentlichti
20. Nov. 2026
Code zuletzt geänderti
20. Nov. 2026
Zuletzt geprüft
20. Nov. 2026
Entwickler
sidorenkav-collab
Pakete
npm: @botarmor/mcp
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 20. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto sidorenkav-collab bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: heute

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt MIT

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 756 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/sidorenkav-collab-botarmor.svg)](https://mcp.popnx.com/en/servers/sidorenkav-collab-botarmor)

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 Suche & KI-Gedächtnisi

  • Mehr Sterne als 0 % der anderen 6470 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 99 % der anderen 6470 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 6470 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 BotArmor: LLM red teaming for chatbots 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?

Das musst du eintragen: BOTARMOR_API_KEY

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 heute geändert, und die neueste Version (0.1.2) kam heute 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: OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)

Ä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

OpenSEO

Keyword research, site audits, rank tracking and AI visibility for your AI agent.

von every-appWeit verbreitet★ 28.285Aktualisiert vor 6 Tagen

Läuft in der Cloud✓ everyapp.com

Exa

Official Exa MCP for web search, content fetching, and multi-step research.

von exa-labsWeit verbreitet★ 5245Aktualisiert heute

Läuft in der Cloud✓ vom Dienst · exa.aiVom PopNx-Team ausprobiert

Microsoft Learn MCP

Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.

von MicrosoftDocsWeit verbreitet★ 2000Aktualisiert vor 12 Monaten

Läuft in der Cloud✓ vom Dienst · microsoft.comVom PopNx-Team ausprobiert

Docs

Search and read Empryo's documentation. Read-only, no auth, no local access.

von proxysoulWachsend★ 1628Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ empryo.com

COTAL actions (cotal.ai)

cotal.ai actions: product overview, site search, build log, feedback, Cloud waitlist, updates, calls

von Cotal-AIWachsend★ 403Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · cotal.ai
Im Vergleich mit ähnlichen
Dieser
BotArmor: LLM red teaming for chatbots
OpenSEOExaMicrosoft Learn MCPDocsCOTAL actions (cotal.ai)
Läuft woIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselJaNeinNeinNeinNeinNein
Mit + in Claude hinzufügenNeinJaJaJaNeinNein
Basisprüfungen5/55/52/44/44/44/4
LizenzMITMITMITCC-BY-4.0NOASSERTIONApache-2.0
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.

BotArmor MCP server

BotArmor is no-code LLM red teaming and prompt injection testing for chatbots and AI agents, built for small businesses and for people who build bots on Make, n8n or Voiceflow. In short: crash-test your bot before your customers do.

This MCP server runs it from your AI assistant: Claude Code, Claude Desktop, ChatGPT, OpenAI Codex, Gemini CLI, Cursor, VS Code (Copilot) or Windsurf. Ask "test my agent with BotArmor" and BotArmor attacks the agent on up to 12 levels:

  • fake manager;
  • angry customer;
  • fake lawyer;
  • prompt injection;
  • role-play;
  • phishing;
  • AI disclosure under the EU AI Act;
  • invented facts;
  • and more.

Level 13 is added for agents with tools. The assistant gets back a report written for it: what broke, how badly, and the exact text to add to the agent's instructions. It can then edit your code and run the audit again.

It is a thin wrapper over the BotArmor API, the same one the Make app, the n8n node and the GitHub Action use.

Who it's for

  • Small businesses with a customer-service bot on their website, WhatsApp or Messenger, who want to know if it can be talked into a discount, a fake promise or an invented price.
  • Freelancers and agencies who deliver bots on Make, n8n or Voiceflow and want a report to hand to their client.
  • Developers who want a quick adversarial check of an agent's system prompt from their editor, without writing a test suite.

If you have a team that writes tests and wants red teaming inside CI, an open-source framework is probably the better fit (see below).

BotArmor vs promptfoo, Giskard and garak

They are good tools and they serve a different user. Open-source frameworks give developers full control. BotArmor gives a verdict and fixes to people who don't write YAML.

BotArmorpromptfooGiskardgarak
Built forSmall businesses, agencies, no-code buildersDevelopersML and product teamsSecurity researchers, ML engineers
What you writeNothing: a prompt, a webhook or a URL, or ask your AI assistantYAML config, CLIPythonCLI options, generator config
Bots on Make, n8n, VoiceflowBuilt in: Make app, verified n8n node, Voiceflow APIThrough an HTTP provider you configureThrough a Python wrapper you writeThrough a REST generator you configure
What you getA–F grade, what broke, the exact text to paste into the system prompt, a signed report for your clientTest results and a red-team reportA scan report of detected issuesA report of probe hit rates
EU AI Act Art. 50 check (does the bot say it's an AI?)Built in, one of the 12 levelsPossible as a custom testPossible as a custom testPossible as a custom probe
Re-test after a fixRun the audit again (start_audit)Re-run the CLIRe-run the scanRe-run the CLI
PriceFree 1-minute quick test; €9 per audit (3 free during the beta)Open source; paid enterprise planOpen source; paid enterprise hubOpen source

Choose promptfoo, Giskard or garak if you build an LLM application in code and want tests in your CI. They are more flexible, and promptfoo in particular is the stronger choice for developer teams.

Choose BotArmor if you deliver or run a customer-facing bot, don't want to maintain a test suite, and need an answer you can act on: what to change in the prompt, and proof that it now holds.

How it works

  1. You ask your assistant. For example: "Check the support agent in this repo with BotArmor."
  2. The assistant calls `start_audit`. It passes the agent's system prompt, which it reads from your code.
  • Prompt mode (default): BotArmor plays that prompt on its own model. Use it for an agent on localhost or not deployed yet.
  • Live mode: BotArmor talks to your running bot at a public https URL. The assistant must first ask you to confirm you own the bot.
  1. BotArmor attacks. For each level it runs 5 adaptive sessions. A judge model rules on each session, and a jury of three models confirms every break. An audit takes 5–20 minutes and uses one credit.
  2. The assistant polls `get_audit_status`. It shows progress: levels done out of total.
  3. It reads `get_audit_report`. The report gives the grade A–F, a table of levels with severity, and for each failed level what happened plus a ready-to-paste fix for the system prompt.
  4. It proposes the fix in your code. With your OK it applies the fix, then runs start_audit again to check that the level now holds.

Your API key stays in your MCP client's configuration. The assistant never receives it. Prompts are not stored by BotArmor, only a SHA-256 fingerprint.

Get an API key

Create a key in the BotArmor dashboard, tab API. It starts with ba_live_. In the examples below, replace ba_live_xxx with it. Keep the key out of your repository: use user-level configuration, or an environment variable.

Connect your assistant

Claude Code
claude mcp add botarmor --scope user -e BOTARMOR_API_KEY=ba_live_xxx -- npx -y @botarmor/mcp

Check with claude mcp list, or /mcp inside a session.

Claude Desktop

Menu Settings → Developer → Edit Config opens claude_desktop_config.json:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Add the server, then fully quit and reopen Claude Desktop:

{

"mcpServers": { "botarmor": { "command": "npx", "args": ["-y", "@botarmor/mcp"], "env": { "BOTARMOR_API_KEY": "ba_live_xxx" } } } }

ChatGPT (web) and claude.ai: remote server, no install

Hosts that only connect to servers on the internet use BotArmor's hosted endpoint:

https://app.botarmor.eu/mcp
  1. Add it as a custom MCP server or connector in your host. In ChatGPT this is the apps and connectors settings with developer mode. In claude.ai it is Settings → Connectors → Add custom connector. Menu names change often; look for "MCP server" or "custom connector".
  2. The host opens a BotArmor page. Paste your API key there and click Connect.
  3. The host receives its own token (OAuth 2.1 with PKCE). It never sees your API key.
  4. To disconnect, remove the connector, or revoke the API key in the BotArmor dashboard.

The tools are the same four.

ChatGPT desktop app and OpenAI Codex (CLI and IDE)

They share one configuration. Use either the command line:

codex mcp add botarmor --env BOTARMOR_API_KEY=ba_live_xxx -- npx -y @botarmor/mcp

or ~/.codex/config.toml:

[mcp_servers.botarmor]

command = "npx" args = ["-y", "@botarmor/mcp"] env = { BOTARMOR_API_KEY = "ba_live_xxx" }

In the ChatGPT desktop app you can also add it under Settings → MCP servers → STDIO, with command npx, arguments -y @botarmor/mcp and the env variable.

Gemini CLI
gemini mcp add -s user -e BOTARMOR_API_KEY=ba_live_xxx botarmor npx -y @botarmor/mcp

or ~/.gemini/settings.json:

{

"mcpServers": { "botarmor": { "command": "npx", "args": ["-y", "@botarmor/mcp"], "env": { "BOTARMOR_API_KEY": "$BOTARMOR_API_KEY" } } } }

$BOTARMOR_API_KEY is read from your shell environment, so the key is not written in the file. Check with /mcp in a session.

Cursor

~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{

"mcpServers": { "botarmor": { "command": "npx", "args": ["-y", "@botarmor/mcp"], "env": { "BOTARMOR_API_KEY": "ba_live_xxx" } } } }

VS Code (GitHub Copilot agent mode)

Run MCP: Open User Configuration from the Command Palette and add the server. VS Code asks for the key once and stores it securely:

{

"inputs": [ { "type": "promptString", "id": "botarmor-key", "description": "BotArmor API key (ba_live_...)", "password": true } ], "servers": { "botarmor": { "type": "stdio", "command": "npx", "args": ["-y", "@botarmor/mcp"], "env": { "BOTARMOR_API_KEY": "${input:botarmor-key}" } } } }

Note that VS Code uses servers, not mcpServers.

Windsurf and other MCP clients

Any client that runs local MCP servers (stdio) works with the same three values:

  • command: npx
  • args: -y @botarmor/mcp
  • env: BOTARMOR_API_KEY

In Windsurf, use the mcpServers block as for Cursor, in ~/.codeium/windsurf/mcp_config.json.

What to ask

  • "Check my agent on localhost:3000 with BotArmor." This runs a prompt audit from the system prompt in your code, because BotArmor's servers cannot reach your localhost.
  • "Audit our staging bot at https://staging.example.com/v1/chat/completions with BotArmor, it's OpenAI-compatible, the token is in .env." This runs a live audit; the assistant asks you to confirm you own the bot.
  • "Is the BotArmor audit done? Show me the report and fix the prompt."
  • "List my last BotArmor audits."

Tools

ToolWhat it does
start_auditStarts an audit and returns its id (BA-XXXXXXXX). It takes 5–20 minutes and uses one audit credit.
get_audit_statusStatus, progress (levels done out of total), and the grade once completed.
get_audit_reportGrade, a table of levels with severity, and for each failed level what happened plus the text to paste into the system prompt.
list_auditsYour latest audits.

start_audit parameters:

  • system_prompt (required): the agent's instructions. For a live audit it is also the rulebook the judge checks answers against.
  • target_type, one of:
  • prompt: the default when no URL is given;
  • openai-compatible: a chat-completions endpoint;
  • webhook: any JSON endpoint.
  • endpoint_url: a public https URL, for live audits.
  • headers: what the target needs. A credential header (Authorization, X-API-Key…) is stored encrypted by BotArmor and never returned.
  • model: for openai-compatible, the model name sent in the body.
  • body_template and response_path: for webhook. The body uses {{input}}, "{{history}}" or "{{messages}}"; the path points to the reply, e.g. data.reply.
  • levels: a subset of logic, toxic, hacker, lawyer, multilang, loop, roleplay, phishing, ethics, burst, disclosure, facts, agency.
  • lang: the report language (fr, en, de, es, ru).
  • min_grade: the pass threshold.
  • authorization_confirmed: must be true for a live audit. Set it only when you own the bot or hold the owner's written permission. BotArmor never tests third-party bots.

Errors you may see

  • "BotArmor rejected the API key": check BOTARMOR_API_KEY.
  • "No audit credit left": buy a pack or upgrade in the dashboard.
  • "... is only reachable from this machine": use target_type: "prompt", or a public tunnel such as cloudflared tunnel --url http://localhost:3000.
  • "the target bot did not answer": the live bot was down, or its URL or headers are wrong.
  • "An audit is already running": one audit at a time per account.

Develop

npm install

npm test # builds, then runs unit tests and an end-to-end stdio test against a mock API

BOTARMOR_API_URL points the server at another API base (default https://app.botarmor.eu/api/v1).

MIT licence. BotArmor AI is a brand of Rhone IA (Andrii Sydorenko EI), France. Reports are point-in-time test attestations, not certifications.