Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas Iniciar sesión

BotArmor: LLM red teaming for chatbots

de sidorenkav-collabversión 0.1.2i★ 0iComputadora o nubeSitio oficial ↗
Nombre en el registroio.github.sidorenkav-collab/botarmor

Cómo instalar

Qué hace

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

Texto original del autor

  • Conexión Computadora o nube
  • Cuenta o clave Nube: Inicias sesión en el servicio al conectar (OAuth) · Local: Necesita BOTARMOR_API_KEY
  • Categoría Búsqueda y memoria de IA

Úsalo junto con

Skills que enseñan a la IA este tipo de trabajo; funcionan junto a este

timesfm

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

de google-research★ 35.6421 skills

Skill · Guía de trabajo

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…

de BigBodyCobain★ 11.6081 skills

Skill · Guía de trabajo

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

de gosom★ 82561 skills

Skill · Guía de trabajo

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad0/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo8/8El endpoint en la nube respondió en la última revisión
Puntuación de uso20/100

Calidad: Pasó 5/5 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala BotArmor: LLM red teaming for chatbots. Sigue https://mcp.popnx.com/i/sidorenkav-collab-botarmor.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 5/5 revisiones · Lo que preguntas pasa por el servidor del autor (app.botarmor.eu) · ✓ Comandos revisados el 20 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude · unos 2 min

Sin clave y sin instalar nada · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner

  1. Abre la página Connectors de Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Pulsa “Add” → “Custom” → “Web” y completa estos 2 campos

    Copia cada valor al campo con el mismo nombre en Claude y pulsa Continue

    Name · NombreBotArmor: LLM red teaming for chatbots
    Remote MCP server URL · Direcciónhttps://app.botarmor.eu/mcp

    Pulsa Continue en la pantalla de inicio de sesión que detectó Claude · en Authentication elige lo que indique el autor (Sign in now, Sign in when needed o No sign in) y pulsa Add

  3. Actívalo en un chat

    +ConnectorsBotArmor: LLM red teaming for chatbots

  4. Pruébalo

    Usa BotArmor: LLM red teaming for chatbots y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando BotArmor: LLM red teaming for chatbots o muestra una herramienta de BotArmor: LLM red teaming for chatbots en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con ChatGPT según tu plan

MCP completo: ChatGPT Business, Enterprise o Edu en la web · Pro: conecta con permisos de lectura/obtención, así que las herramientas que cambian datos pueden no funcionar · Plus: no confirmado en la documentación; si ves una opción para añadir MCP propio en la página de plugins puedes probar · solo web

  1. Abre la página para añadir MCP en ChatGPT web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Escribe el nombre y la dirección

    Pon un nombre, pega la dirección en Connection, marca el aviso de riesgo y pulsa Create as a plugin

    Name · NombreBotArmor: LLM red teaming for chatbots
    Connection · Direcciónhttps://app.botarmor.eu/mcp
  3. Elige BotArmor: LLM red teaming for chatbots en un chat

    Abre un chat nuevo y elige BotArmor: LLM red teaming for chatbots en tus plugins antes de escribir

  4. Pruébalo

    Usa BotArmor: LLM red teaming for chatbots y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si ChatGPT dice que está usando BotArmor: LLM red teaming for chatbots o muestra una herramienta de BotArmor: LLM red teaming for chatbots en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de OpenAI el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Claude Code · unos 2 min

Sin clave y sin instalar nada

  1. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  2. Pega este comando y pulsa Enter

    claude mcp add --transport http --scope user botarmor https://app.botarmor.eu/mcp
  3. Escribe /mcp en Claude Code

    Deberías ver BotArmor: LLM red teaming for chatbots en la lista como conectado

  4. Pruébalo

    Usa BotArmor: LLM red teaming for chatbots y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando BotArmor: LLM red teaming for chatbots o muestra una herramienta de BotArmor: LLM red teaming for chatbots en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de Cursor en modo Agent

  3. Pruébalo

    Usa BotArmor: LLM red teaming for chatbots y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando BotArmor: LLM red teaming for chatbots o muestra una herramienta de BotArmor: LLM red teaming for chatbots en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de VS Code en modo Agent

  3. Pruébalo

    Usa BotArmor: LLM red teaming for chatbots y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando BotArmor: LLM red teaming for chatbots o muestra una herramienta de BotArmor: LLM red teaming for chatbots en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

Dirección para apps que se conectan por la web

Direcciónhttps://app.botarmor.eu/mcp

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa BotArmor: LLM red teaming for chatbots💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

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

Instalado en tu computadora

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

Valores que debes completar

  • BOTARMOR_API_KEY secreto obligatorio env
    Clave de API de BotArmor (ba_live_...), desde el área de cliente, pestaña API.
    Ver original en inglésBotArmor API key (ba_live_...), from the client area, tab API

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
23/sem
Conexión
Computadora o nube
Transporte
stdio, streamable-http
Última versióni
0.1.2
Publicado en el registroi
20 nov 2026
Último cambio de códigoi
20 nov 2026
Última revisión
20 nov 2026
Creador
sidorenkav-collab
Paquetes
npm: @botarmor/mcp
Sitio web
botarmor.eu
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se conectan por internet en

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

Se ejecutan en tu computadora en

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

Todas las apps, con ventajas y desventajas →

Qué puede hacer

El servidor pide iniciar sesión antes de mostrar sus herramientas.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 20 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub sidorenkav-collab, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hoy

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • ✓ Superada

    El endpoint responde

    Respondió en 756 ms (HTTP 401)

  • ✓ Superada

    Inicio de sesión con OAuth

    Declara inicio de sesión con OAuth, así que tu app de IA puede llevarte a iniciar sesión

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Aún sin revisar; leemos la lista de herramientas cuando revisamos el endpoint

Vulnerabilidades publicadas (OSV.dev)

Aún no revisado

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

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

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Búsqueda y memoria de IAi

  • Más estrellas que el 0% de los otros 6470 servidores de esta categoría
  • Publicado en el registro más recientemente que el 99% de los otros 6470 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 6470 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro BotArmor: LLM red teaming for chatbots?

Superó 5 de 5 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: BOTARMOR_API_KEY

¿Se ejecuta en mi computadora o en la nube?

Funciona de las dos formas: instálalo en tu computadora o conéctate a la versión en la nube.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hoy, y la última versión (0.1.2) llegó al registro hoy.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también sirve en apps que aceptan MCP remoto, como ChatGPT en la web (MCP completo en Business y superiores; Pro solo lectura).

¿Qué puedo usar en su lugar?

En la misma categoría: OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

OpenSEO

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

de every-appMuy usado★ 28,3 milActualizado hace 6 días

Se ejecuta en la nube✓ everyapp.com

Exa

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

de exa-labsMuy usado★ 5,2 milActualizado hoy

Se ejecuta en la nube✓ del servicio · exa.aiProbado por el equipo de PopNx

Microsoft Learn MCP

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

de MicrosoftDocsMuy usado★ 2 milActualizado hace 12 meses

Se ejecuta en la nube✓ del servicio · microsoft.comProbado por el equipo de PopNx

Docs

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

de proxysoulEn crecimiento★ 1,6 milActualizado hace 2 meses

Se ejecuta en la nube✓ empryo.com

COTAL actions (cotal.ai)

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

de Cotal-AIEn crecimiento★ 403Actualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · cotal.ai
Comparado con otros parecidos
Este
BotArmor: LLM red teaming for chatbots
OpenSEOExaMicrosoft Learn MCPDocsCOTAL actions (cotal.ai)
Dónde se ejecutaEn la nube o instalado en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveSíNoNoNoNoNo
Se añade con + en ClaudeNoSíSíSíNoNo
Revisiones básicas5/55/52/44/44/44/4
LicenciaMITMITMITCC-BY-4.0NOASSERTIONApache-2.0
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

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.