# Decoy Redteam

> Autonomous red team for MCP servers. Sends adversarial payloads to your tools, proves exploitation, reports what's broken. 53 attack patterns across 6 categories. Zero dependencies. npx decoy-redteam

- **Type:** MCP server
- **Install:** `agentstack add mcp-decoy-run-decoy-redteam`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [decoy-run](https://agentstack.voostack.com/s/decoy-run)
- **Installs:** 0
- **Category:** [Security](https://agentstack.voostack.com/c/security)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [decoy-run](https://github.com/decoy-run)
- **Source:** https://github.com/decoy-run/decoy-redteam
- **Website:** https://www.npmjs.com/package/decoy-redteam

## Install

```sh
agentstack add mcp-decoy-run-decoy-redteam
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

Decoy Red Team

  
  
  
  

Autonomous red team for MCP servers. Finds exploitable vulnerabilities before attackers do. Zero dependencies. Zero setup.

**Works with:** Claude Desktop, Cursor, Windsurf, VS Code, Claude Code, Zed, Cline

## 🚀 Get Started

```bash
npx decoy-redteam            # Dry-run — show attack plan
npx decoy-redteam --live     # Execute attacks against your MCP servers
```

Decoy Red Team connects to every MCP server on your machine, sends adversarial payloads to their tools, and reports what's exploitable. Not a scanner — an attacker.

## 🧑‍💻 Install

No install required — run directly with `npx`. Requires Node.js 18+.

Or pin it in your CI:

```yaml
- name: Red team MCP servers
  uses: decoy-run/decoy-redteam@v1
  with:
    target: my-server
    token: ${{ secrets.DECOY_TOKEN }}
    sarif: true
```

## 🎓 Docs

- [Overview](https://decoy.run/docs/redteam/overview)
- [OWASP Top 10 for Agentic Applications 2026](https://genai.owasp.org/resource/owasp-top-10-for-agentic-applications-for-2026/)

## 🗂 What it tests

**54 active attacks + 5 passive poisoning checks** across 7 categories:

| Category | What it tests |
|----------|---------------|
| Input injection | SQL injection, command injection, path traversal, SSRF, template injection (SSTI → RCE) |
| Prompt injection | Instruction override, role hijack, indirect injection, encoding bypass, multi-turn |
| Credential exposure | .env files, cloud credentials, SSH keys, git tokens, shell history |
| Protocol attacks | Malformed JSON-RPC, capability escalation, replay attacks, method injection |
| Schema boundary | Type coercion, null bytes, overflow, prototype pollution, NoSQL operators |
| Privilege escalation | Scope escape, undeclared access, dotfile enumeration, argument smuggling |
| Tool poisoning | Instruction override, concealment directives, embedded exfiltration, fake system framing, invisible-character smuggling — read from the live tool surface, **runs in dry-run** |

Every finding maps to [OWASP Top 10 for Agentic Applications 2026](https://genai.owasp.org/resource/owasp-top-10-for-agentic-applications-for-2026/).

## 🛡 Safety

**Dry-run by default.** Running `npx decoy-redteam` without `--live` shows what would be tested without executing anything.

**Confirmation required.** `--live` prompts for explicit confirmation before executing. No `--yes` bypass flag.

**Safe mode default.** Live execution only runs read-only and protocol attacks. Destructive attacks require `--live --full` with an additional warning.

**Browser-automation tools are skipped in safe mode.** Tools matching `browser_*`, `navigate`, `goto`, `open_url`, `open_browser`, `open_tab`, `open_page`, `open_window`, `take_screenshot`, `screenshot`, or `screencapture` are excluded by default — otherwise SSRF URL payloads cause real browser windows to flicker open for each attack. Opt in with `--full`.

## 🛠 Usage

```bash
# Dry-run — show attack plan without executing anything
npx decoy-redteam

# Execute attacks against your MCP servers
npx decoy-redteam --live

# Target a specific server
npx decoy-redteam --live --target=my-server

# JSON output for scripting
npx decoy-redteam --live --json

# SARIF output for GitHub Security / CI
npx decoy-redteam --live --sarif

# Only test specific categories
npx decoy-redteam --live --category=input-injection,credential-exposure
```

### Exit codes

| Code | Meaning |
|------|---------|
| 0 | No critical or high findings |
| 1 | High-risk findings |
| 2 | Critical findings |

## 🤖 Advanced AI-powered red team (paid plans)

Free `decoy-redteam` runs 54 deterministic attacks plus 5 passive tool-poisoning checks. The paid tiers on [Decoy Guard](https://decoy.run/pricing) (Team $29/user/mo, Business $99/user/mo) add:

- **AI-adaptive attacks** — LLM-generated payloads specific to your tool schemas
- **Encoding bypass suite** — 25+ encoding variants per injection vector
- **Cross-server chain discovery** — finds attack paths across multiple servers
- **Exportable HTML reports** — branded, print-ready security assessments
- **Continuous red teaming** — scheduled runs against your live MCPs

Run with `--team --token=YOUR_TOKEN`.

## 📚 Library

```javascript
import {
  discoverConfigs,
  probeServers,
  planAttacks,
  executeAttacks,
  buildStories,
  calculateCoverage,
  toSarif,
  toJson,
  ATTACKS,
  ENCODINGS,
} from 'decoy-redteam';
```

## 🚢 Release Notes

See the [hosted changelog](https://decoy.run/changelog).

## 🤝 Contribute

See [CONTRIBUTING.md](CONTRIBUTING.md).

## 🔗 Related

- [decoy-scan](https://npmjs.com/package/decoy-scan) — MCP vulnerability scanner (static analysis)
- [decoy-tripwire](https://npmjs.com/package/decoy-tripwire) — Tripwire detection for AI agents
- [Decoy Guard](https://decoy.run) — Dashboard, monitoring, threat intelligence

## 📝 License

MIT — see [LICENSE](LICENSE).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [decoy-run](https://github.com/decoy-run)
- **Source:** [decoy-run/decoy-redteam](https://github.com/decoy-run/decoy-redteam)
- **License:** MIT
- **Homepage:** https://www.npmjs.com/package/decoy-redteam

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-decoy-run-decoy-redteam
- Seller: https://agentstack.voostack.com/s/decoy-run
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
