プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説 ログイン

BotArmor: LLM red teaming for chatbots

作者:sidorenkav-collabバージョン 0.1.2i★ 0iパソコンでもクラウドでも公式サイト ↗
レジストリ名io.github.sidorenkav-collab/botarmor

インストール方法

できること

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

作者による原文

  • 接続方法 パソコンでもクラウドでも
  • アカウントまたはキー クラウド:接続時にサービスへログイン(OAuth) · ローカル:BOTARMOR_API_KEY が必要
  • カテゴリ 検索・AIの記憶

一緒に使える

この種の作業を AI に教える Skill。これと一緒に使えます

timesfm

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

作者:google-research★ 35,6421 個の skill

Skill · 手順書

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…

作者:BigBodyCobain★ 11,6081 個の skill

Skill · 手順書

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

作者:gosom★ 8,2561 個の skill

Skill · 手順書

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気0/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中8/8前回の確認でクラウドのエンドポイントが応答
利用スコア20/100

品質: 基本チェック 5/5 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

BotArmor: LLM red teaming for chatbots をインストールして。https://mcp.popnx.com/i/sidorenkav-collab-botarmor.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 5/5 合格 · 質問内容は提供元のサーバー(app.botarmor.eu)を通ります · ✓ コマンド確認済み 2026年11月20日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげます · 約 2 分

キー不要、インストール不要 · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加

  1. Claude の Connectors ページを開く

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. 「Add」→「Custom」→「Web」を押し、この 2 つを入力

    ここからコピーして Claude の同じ名前の欄に貼り付け、Continue を押します

    Name · 名前BotArmor: LLM red teaming for chatbots
    Remote MCP server URL · アドレスhttps://app.botarmor.eu/mcp

    Claude が検出したサインイン設定の画面で Continue を押す · Authentication は作者の説明どおり(Sign in now・Sign in when needed・No sign in)を選び Add を押します

  3. チャットで有効にする

    +ConnectorsBotArmor: LLM red teaming for chatbots

  4. 試してみる

    BotArmor: LLM red teaming for chatbots を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が BotArmor: LLM red teaming for chatbots を使っていると言うか、回答に BotArmor: LLM red teaming for chatbots のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT との接続はプランしだい

フル MCP:Web 版 ChatGPT の Business・Enterprise・Edu · Pro:読み取り/取得の権限で接続、データを変えるツールは使えないことがあります · Plus:公式ドキュメントで未確認。プラグイン画面にカスタム MCP を追加する項目があれば試せます · Web のみ

  1. Web 版 ChatGPT で MCP の追加ページを開く

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. 名前とアドレスを入力

    名前を入れ、Connection にアドレスを貼り付け、注意事項にチェックして Create as a plugin を押します

    Name · 名前BotArmor: LLM red teaming for chatbots
    Connection · アドレスhttps://app.botarmor.eu/mcp
  3. チャットで BotArmor: LLM red teaming for chatbots を選ぶ

    新しいチャットを開き、入力前にプラグインの一覧から BotArmor: LLM red teaming for chatbots を選びます

  4. 試してみる

    BotArmor: LLM red teaming for chatbots を使って、私に何ができるか教えて、1 つやってみせて

    ✓ ChatGPT が BotArmor: LLM red teaming for chatbots を使っていると言うか、回答に BotArmor: LLM red teaming for chatbots のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に OpenAI のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Claude Code につなげます · 約 2 分

キー不要、インストール不要

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  2. このコマンドを貼り付けて Enter

    claude mcp add --transport http --scope user botarmor https://app.botarmor.eu/mcp
  3. Claude Code で /mcp と入力

    BotArmor: LLM red teaming for chatbots が一覧にあり、接続済みと表示されれば OK です

  4. 試してみる

    BotArmor: LLM red teaming for chatbots を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が BotArmor: LLM red teaming for chatbots を使っていると言うか、回答に BotArmor: LLM red teaming for chatbots のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  2. Cursor の AI チャットを Agent モードで開く

  3. 試してみる

    BotArmor: LLM red teaming for chatbots を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が BotArmor: LLM red teaming for chatbots を使っていると言うか、回答に BotArmor: LLM red teaming for chatbots のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  2. VS Code の AI チャットを Agent モードで開く

  3. 試してみる

    BotArmor: LLM red teaming for chatbots を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が BotArmor: LLM red teaming for chatbots を使っていると言うか、回答に BotArmor: LLM red teaming for chatbots のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

Web 経由でつなぐアプリ用のアドレス

アドレスhttps://app.botarmor.eu/mcp

JSON 設定は下の「開発者向け」にあります

つまずいたら?BotArmor: LLM red teaming for chatbots を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

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"
    }
  }
}

パソコンにインストール

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"
      }
    }
  }
}

自分で入力する値

  • BOTARMOR_API_KEY 秘密 必須 env
    BotArmor API キー(ba_live_...)。クライアントエリアの API タブから取得します。
    英語の原文を見るBotArmor API key (ba_live_...), from the client area, tab API

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
23/週
接続方法
パソコンでもクラウドでも
最新バージョンi
0.1.2
レジストリ公開日i
2026年11月20日
コードの最終更新i
2026年11月20日
最終確認
2026年11月20日
作者
sidorenkav-collab
パッケージ
npm: @botarmor/mcp
ウェブサイト
botarmor.eu
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

インターネット経由でつなげるアプリ

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

パソコン上で動かせるアプリ

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

すべてのアプリと長所・短所 →

できること

このサーバーは、ツール一覧を表示する前にサインインを求めます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月20日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント sidorenkav-collab で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:今日

  • ✓ 合格

    ライセンスがある

    MITを使用

  • ✓ 合格

    エンドポイントが応答する

    756ミリ秒で応答(HTTP 401)

  • ✓ 合格

    OAuthでサインイン

    OAuthでのサインインに対応しているため、AIアプリがログイン画面へ案内してくれます

  • … 未チェック

    ツールの説明に隠れた指示がない

    まだチェックしていません。エンドポイントをチェックするときにツール一覧を読み取ります

公開済みの脆弱性(OSV.dev)

まだ確認していません

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

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

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

検索・AIの記憶のほかのサーバーとの比較i

  • このカテゴリのほかの6470件のうち0%よりスターが多い
  • このカテゴリのほかの6470件のうち99%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの6470件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

BotArmor: LLM red teaming for chatbotsは安全ですか?

当てはまる基本チェック5項目のうち5項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:BOTARMOR_API_KEY

パソコンで動きますか、それともクラウドですか?

どちらでも使えます。パソコンにインストールしても、クラウド版につないでもかまいません。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は今日、最新バージョン(0.1.2)がレジストリに届いたのは今日です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。

代わりに使えるものは?

同じカテゴリには:OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

OpenSEO

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

作者:every-app広く使われている★ 2.8万6 日前更新

クラウドで動く✓ everyapp.com

Exa

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

作者:exa-labs広く使われている★ 5245今日更新

クラウドで動く✓ 提供元 · exa.aiPopNx チームが実際に試用

Microsoft Learn MCP

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

作者:MicrosoftDocs広く使われている★ 200012 か月前更新

クラウドで動く✓ 提供元 · microsoft.comPopNx チームが実際に試用

Docs

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

作者:proxysoul成長中★ 16282 か月前更新

クラウドで動く✓ empryo.com
似たものと比べる
これ
BotArmor: LLM red teaming for chatbots
OpenSEOExaMicrosoft Learn MCPDocsCOTAL actions (cotal.ai)
動く場所クラウドでもパソコンにインストールでも使えるクラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要はいいいえいいえいいえいいえいいえ
Claude で + から追加いいえはいはいはいいいえいいえ
基本チェック5/55/52/44/44/44/4
ライセンスMITMITMITCC-BY-4.0NOASSERTIONApache-2.0
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

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.