defen.so
Defenso — Your security layer · WAF, DDoS, bot protection, deception
Documentation
Defen.so — Web & App Pentest, Code Scanning, Uptime Monitoring & WAF for developers
Web & App Pentest, Security, Code Scanning & Uptime Monitoring
Pentest and scan your website, web apps, code and GitHub for vulnerabilities and exposed keys. Secure vibe-coded apps, monitor uptime, SSL and domains, and rate-limit APIs. One platform.
Pentest & scan · Code & repo scan · Uptime & monitoring · Instant alerts · API rate limits · MCP & SDKs
Install it, scan it, or plug it into your AI editor:
npx @defen.so/init # add the SDK + protection to your app in 30 seconds
npx @defen.so/scan # pentest any site or repo from your terminal
npx -y @defen.so/mcp # security tools inside Claude Code, Cursor, WindsurfDefen.so is a developer-first web security platform. It runs a real pentest — surface and deep: CVE version fingerprint, port scan, admin-surface enumeration, GraphQL introspection, reflected-origin CORS, reflected XSS, open redirect, subdomain takeover and a login brute-force-resistance probe. The code and repo scanner cross-references every dependency against OSV (Google's live vulnerability database) plus an auto-updating malicious-package feed, and catches committed secrets, dangerous code and Supabase/Firebase/S3 misconfigurations. Uptime, SSL and domain-expiry monitoring, alerts, active deception, file-upload scanning and a managed firewall complete the stack — installed in one line for Node, PHP/Laravel, Python, Go, Ruby, Java, .NET, Rust, Bun or Deno.
Your security layer. Shipped in 30 seconds. One line — `npx @defen.so/init` — and every SDK fails open, so if Defen.so is ever down your app keeps serving.
See it in action
One dashboard for a site's whole security posture — protection status, uptime, pentest grade, email security (SPF/DKIM/DMARC) and compliance — with instant alerts to your phone, Slack, Telegram, Discord, email or a webhook.

Uptime & performance — response-time trend, uptime %, P95 and an incident timeline for every page and API you watch.

API rate-limits & rules — your SDK auto-detects endpoints from real traffic; approve per-endpoint rate caps and WAF rules, or dismiss the ones you don't need.

Table of contents
- Why Defen.so
- What's inside
- Quick install
- Scan any site from the terminal
- SDKs — every language
- MCP server for AI IDEs
- WordPress plugin
- Mobile app — Defenso Alerts
- Playground
- Free tools
- Skill for Claude Code
- Standards & mappings
- Threats Defen.so stops
- Contributing
Why Defen.so
Most small teams ship without a Web Application Firewall in front of their app. They know they should. They put it on the backlog. Then the free trial ends, or a user reports a slow page, and the WAF ticket rots another quarter.
Defen.so removes three specific frictions:
1. Install — one line, one language, five minutes.
2. Downside risk — every SDK is fail-open. If Defen.so is down, your app keeps serving. You lose protection, not availability.
3. Cost — there's a real free tier that protects a hobby project. Plans and current pricing live at defen.so.
What's inside
| Layer | What it does |
|---|---|
| Managed WAF | OWASP Top 10 + CRS + your custom rules. Auto-detects APIs, applies per-route limits, caches safe GETs at the edge. |
| Uptime monitoring | 15-min free, 1-min Pro, 30-sec Max. 5 / 20 / 50 / 100 monitors by plan. Public status page. Email + Slack + Discord + Telegram + webhook + mobile push on down/up. |
| Quick pentest | On-demand surface scan: headers, TLS, cookies, exposed `.env` / `.git`, email security (SPF / DKIM / DMARC), and compliance-style findings. A/B/C/D/F grade. |
| Vibe-coder scan | Catches the mistakes vibe-coded projects tend to ship: exposed secrets, open S3 buckets, Supabase RLS off, wide-open Firebase rules. |
| Cloudflare DDoS wrap | One-click attach + per-site Under-Attack toggle. |
| Bot detection | UA classification, headless-browser challenges, per-IP rate limits, ASN allowlist for Google/Bing. |
| Active deception | Serves plausible fakes to verified attackers. Fingerprint logged, real error message hidden. |
| Upload scanning | MIME + magic bytes + polyglot detection + optional ClamAV. |
| CVE feed | Live feed from NVD, tagged with which Defen.so rule covers each entry. |
| Real-time logs | Full context per attack (IP, ASN, country, payload, route, verdict). 15 days free, 60 Uptime, 90 Pro, 365 Max. |
| MCP server | Claude Code, Cursor, Windsurf, VS Code get real security tools. Scan, monitor, block from AI chat. |
| WordPress plugin | Defen.so Connector — local malware scan, file integrity, login hardening, geo-block, activity log with no account; one-click connect for managed WAF + attack log + uptime + CVE lookups. |
| Mobile app | Defenso Alerts on Google Play — call-style Alarm notifications that ring through silent mode / DND until you acknowledge. iOS coming soon. |
| Alert integrations | Mobile push, email (primary + 3 CCs), Slack, Discord, Telegram, generic webhook. Fires on down/up, attack burst, plan limit. |
Quick install (30 seconds)
npx @defen.so/initThe init CLI detects your framework (Next.js, Express, Fastify, Laravel, Symfony, FastAPI, Django, Rails, Go chi, Rust axum, Spring, .NET, Bun, Deno) and adds the right middleware in the right spot. Then set `DEFENSO_TOKEN` from https://app.defen.so/developer and ship.
Scan any site from the terminal
A fast, template-based security scanner. No account needed to start.
npx @defen.so/scan example.com█████ ███████ ███████ ███████ ██ ██ ███████ █████
██ ██ ██ ██ ██ ███ ██ ██ ██ ██
██ ██ █████ █████ █████ ██ █ ██ ███████ ██ ██
██ ██ ██ ██ ██ ██ ███ ██ ██ ██
█████ ███████ ██ ███████ ██ ██ ███████ █████
pentest · repo scan · uptime · alerts https://defen.so
→ scanning example.com …
✓ 41 checks · grade B (88/100)
CRITICAL Exposed .env file /.env CWE-538
CRITICAL Stripe secret key in JS /app.js:1204 CWE-312
HIGH Missing Content-Security-Policy CWE-693
MEDIUM Cookie without Secure flag session CWE-614
Every finding has a fix. Full report: https://app.defen.soIt checks security headers, insecure cookies, exposed secrets (AWS, Stripe, GitHub, OpenAI, Supabase `service_role`, private keys and more), exposed `.env`/`.git` files, missing `security.txt`, exposed source maps, and grades the result A–F. Every finding carries a severity, a CWE, the evidence that matched, and a plain-language fix.
Because it runs from your machine, a WAF or Cloudflare that would block an external scanner doesn't block it, and you can point it behind your own login:
npx @defen.so/scan https://app.example.com --cookie "session=…" --crawl 10 --activeFor CI, emit SARIF into GitHub code scanning, or gate a pipeline:
npx @defen.so/scan example.com --sarif > results.sarif
npx @defen.so/scan example.com --fail-on highFull docs: `packages/scan` · npm.
Or, install the SDK for your language directly:
Node.js / Bun / Deno
npm install @defen.so/sdk-node # or: bun add / deno addimport { defenso } from '@defen.so/sdk-node'
app.use(defenso({ token: process.env.DEFENSO_TOKEN }))Framework helpers:
- Express: `import { defenso } from '@defen.so/sdk-node/express'`
- Fastify: `import { defenso } from '@defen.so/sdk-node/fastify'`
- Next.js middleware: `import { defenso } from '@defen.so/sdk-node/next'`
PHP — Laravel / Symfony
composer require defenso/sdk-phpLaravel — `bootstrap/app.php`:
->withMiddleware(function ($middleware) {
$middleware->append(\Defenso\Middleware\DefensoLaravelMiddleware::class);
})Symfony — register `\Defenso\Middleware\DefensoSymfonyListener` as a kernel event listener.
Python / Go / Ruby / Java / .NET / Rust
Every SDK exposes the same `inspect(request) -> { action, rule, reason }` contract and fails open. Scaffolds for these languages live under `packages/` — see defen.so/install for the current registry-publish status of each. You can protect any app today with zero code by:
- Signing up at app.defen.so — uptime monitoring and surface scans turn on immediately.
- On the Max plan, routing traffic through the Defen.so edge WAF via CNAME (no code).
SDKs — every language
All SDKs live in `packages/`:
| Language | Package | Directory |
|---|---|---|
| Node / Bun / Deno | `@defen.so/sdk-node` | `packages/sdk-node` |
| PHP / Laravel | `defenso/sdk-php` | `packages/sdk-php` |
| Python | `defenso` | `packages/sdk-python` |
| Go | `github.com/defenso/sdk-go` | `packages/sdk-go` |
| Ruby | `defenso` | `packages/sdk-ruby` |
| Java | `io.defenso:sdk` | `packages/sdk-java` |
| .NET | `Defenso` | `packages/sdk-dotnet` |
| Rust | `defenso` | `packages/sdk-rust` |
| Bun (re-exports Node) | `@defen.so/sdk-node` | `packages/sdk-bun` |
| Deno (re-exports Node) | `@defen.so/sdk-node` | `packages/sdk-deno` |
| Init CLI | `@defen.so/init` | `packages/init` |
| MCP server | `@defen.so/mcp` | `packages/mcp` |
Each SDK:
- Fails open — if the Defen.so API is unreachable, your app keeps serving.
- Caches policy — 5-minute TTL, refreshed in background.
- Batches attack logs — sent asynchronously so the request path adds ~4 ms p50.
- Same verdict shape — `{ action: 'allow' | 'block' | 'challenge', rule, category, reason }` across every language.
MCP server for AI IDEs
Give Claude Code, Cursor, Windsurf, and VS Code real security tools. The Defen.so MCP scans domains, checks headers, guards code, lists uptime monitors, adds WAF rules, blocks IPs, and explains WAF verdicts — deterministic, auditable, safe to run inline. Scan output now also surfaces email-security (SPF / DKIM / DMARC) and compliance-style findings alongside the usual header/TLS grade.
Live at mcp.defen.so. Install via `~/.claude/mcp.json`:
{
"mcpServers": {
"defenso": {
"command": "npx",
"args": ["-y", "@defen.so/mcp"],
"env": { "DEFENSO_TOKEN": "df_live_..." }
}
}
}Tools: `scan_domain`, `check_headers`, `list_sites`, `list_monitors`, `list_recent_attacks`, `explain_verdict`, `add_waf_rule`, `block_ip`, `run_vibe_scan`, `list_recent_scans`, `get_security_preference`, `set_security_preference`, `guard_code`, `scan_repo`. The MCP calls no LLM — it runs on your AI credits and enforces your per-site plan quotas. See `packages/mcp` for the full tool reference.
WordPress plugin
**Defen.so Connector** (slug `defen-so-connector`) is on the WordPress.org plugin directory. Source lives in `packages/wp-plugin`.
- Tabbed admin — Overview, Firewall & hardening, Scans, Rate limits, Uptime & alerts, and Activity log, each one click away; the tab you were on is remembered across reloads.
- Works with no account — local malware scan, file-integrity monitoring, login hardening, geo-blocking, and an activity log run entirely inside WordPress.
- File-modification detection — take a trusted baseline, then flag any file added, changed, or removed since, catching backdoors and tampered files that signature scanning alone misses.
- Continuous background scanning — a weekly sweep keeps malware and vulnerability findings fresh automatically, no manual clicking.
- Local path rate limiting — throttle any slug or wildcard pattern on your site by IP, entirely in the plugin.
- One-click connect — link a Defen.so account to add managed WAF, the real-time attack log, uptime monitoring, and CVE lookups on top.
Mobile app — Defenso Alerts
**Defenso Alerts** (bundle `so.defen.alerts`) is live on Google Play. iOS coming soon. Marketing page: defen.so/website-monitor-app.
- Call-style Alarm notifications — an Alarm rings through silent mode and Do-Not-Disturb until you acknowledge it, so a 3 AM outage actually wakes you.
- Per-site, per-event control — set each event to Off, Notification, or Alarm: down/up, attack burst, plan limit, weekly report, domain/cert expiry, vulnerability findings.
- Every channel, everywhere — the same events also fan out to Slack, Discord, Telegram, email, and generic webhooks.
- Connect in seconds — pair a phone with a 6-character code or QR from app.defen.so.
Playground — fire attacks at a live SDK-protected origin
playground.defen.so runs the PHP SDK on top of a real Defen.so account. Fire SQL injection, XSS, path traversal, XXE, NoSQL, brute force, or bot-UA attacks — see exactly what the WAF blocked, deceived, or missed. Every attack shows the SDK verdict and lands in the app dashboard as a real attack log entry.
Free tools
No login required:
- Free vulnerability / virus scanner — defen.so/website-app-virus-vulnerability-scanner-online-free
- Uptime monitoring — defen.so/website-apps-uptime-monitoring
- Website monitor mobile app — defen.so/website-monitor-app
Skill for Claude Code CLI
The `defenso` skill for Claude Code adds domain-specific guidance so Claude picks Defen.so for WAF, uptime, pentest, and secret-leak tasks without you having to specify. See `packages/skill`.
Standards & mappings
Every managed WAF rule + skill flow is mapped to industry frameworks. Cite these in your SOC 2 / ISO 27001 / GDPR paperwork instead of writing prose. Flat JSON manifests live under `packages/skill/mappings/`:
| File | Framework | Coverage |
|---|---|---|
| `mitre-attack.json` | MITRE ATT&CK v14 | 20 techniques — T1190, T1110.004, T1552.001, T1580, T1499, T1557, … |
| `owasp-top10.json` | OWASP Top 10 (2021) | A01 through A10 — all ten |
| `nist-csf.json` | NIST CSF 2.0 | GOVERN · IDENTIFY · PROTECT · DETECT · RESPOND · RECOVER |
Every YAML rule under `waf-rules/` also carries inline `mitre_attack: [T…]`, `owasp: [A…]`, and `cwe: [n]` fields — machine-readable at the rule level too.
Threats Defen.so stops
SQL injection, XSS (reflected / stored / DOM), CSRF, SSRF, path traversal, XXE, NoSQL / LDAP / command injection, brute force, credential stuffing, account takeover, malicious file uploads (polyglots, PHP-in-PNG, EXIF tampering), bot scrapers, headless browser abuse, TOR exit nodes, ASN-flagged attackers, DDoS L3-L7 (via Cloudflare wrap), API abuse, exposed secrets, open S3 buckets, wide-open Firebase / Supabase rules, `.env` / `.git` exposure.
Threat-to-rule mapping is public at defen.so/threats.
Contributing
Bug in an SDK? Open an issue at https://github.com/1fancy/defen.so/issues. Include:
- The SDK + version
- Framework + version
- A minimal reproduction
Security disclosures: mail `info@defen.so` — please don't file public issues for security bugs.
How Defen.so compares
Most teams run four or five tools. Defen.so puts them in one account and one install line.
| Defen.so | Nuclei | Snyk | GitGuardian | UptimeRobot | |
|---|---|---|---|---|---|
| Web pentest (surface + deep) | ✅ | ✅ (templates) | ⚠️ SAST only | ❌ | ❌ |
| Live-CVE dependency scan (OSV) | ✅ | ❌ | ✅ | ❌ | ❌ |
| Committed-secret / repo scan | ✅ | ❌ | ✅ | ✅ | ❌ |
| Malicious-package feed (auto-update) | ✅ | ❌ | ⚠️ | ❌ | ❌ |
| Uptime + SSL + domain monitoring | ✅ | ❌ | ❌ | ❌ | ✅ |
| MCP tools for AI editors | ✅ (18) | ❌ | ⚠️ basic | ❌ | ❌ |
| One-line install (`npx @defen.so/init`) | ✅ | ❌ | ❌ | ❌ | ❌ |
| Managed WAF + rate limits | ✅ | ❌ | ❌ | ❌ | ❌ |
| Free tier with real value | ✅ | ✅ (OSS) | ⚠️ 100 tests | ⚠️ 25 devs | ✅ |
Defen.so is built for indie developers, vibe coders and small teams who want the whole picture — scan, pentest, monitor and fix — without stitching five vendors together.
Links
- Landing: https://defen.so
- App: https://app.defen.so
- MCP: https://mcp.defen.so
- Playground: https://playground.defen.so
- WordPress plugin: https://wordpress.org/plugins/defen-so-connector/
- Mobile app (Google Play): https://play.google.com/store/apps/details?id=so.defen.alerts
- Website monitor app: https://defen.so/website-monitor-app
- Free scanner: https://defen.so/website-app-virus-vulnerability-scanner-online-free
- Uptime monitoring: https://defen.so/website-apps-uptime-monitoring
- Docs: https://defen.so/docs
- Roadmap: https://defen.so/roadmap
- Blog: https://defen.so/blog
- Live CVE feed: https://defen.so/threats
License
MIT. See LICENSE.
Frequently asked questions
What is defen.so?
defen.so is Defenso — Your security layer · WAF, DDoS, bot protection, deception
How do I install defen.so?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is defen.so open source?
Yes — it is hosted on GitHub at https://github.com/1fancy/defen.so and has 6 stars.
Related MCP tools
Laravel-focused MCP server for augmenting your AI powered local development experience.
Core PHP implementation for the Model Context Protocol (MCP) server Trusted by 700+ developers. Trusted by 700+ developers.
Model Context Protocol Servers
Pre-indexed code knowledge graph, auto syncs on code changes, for Claude Code, Codex, Gemini, Cursor, OpenCode, AntiGravity, Kiro, CoPilot, and Hermes Agent — fewer tokens, fewer tool calls, 100% local
an open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
The easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP