Guardian Samurai docs
Guides and how-tos for testing and scanning your MCP servers.
Getting started
- Quick Start
Install the Guardian CLI, sign in to get your token, and run your first test, with copy-ready commands for macOS, Windows and Linux.
Websites
- The Websites page
Save a website, choose local or production, confirm ownership, share it with your organization, and copy the command that scans a local website from the CLI.
MCP servers
- Add an MCP server
Save an MCP server to your organization, mark it as a production server, and confirm that you own it so tests can call tools that change data.
- Private and shared servers
Learn how the CLI saves tested servers to your private list, and how to share a server with your organization or stop sharing it.
Samurai Quality
Scans
- Run your first scan
Add an MCP server, mark it as a production server, scan it from MCP Scan, and read its score, categories and findings.
Tests
- Run your first test
Test an MCP server's tools from your account, choose which test categories to run, and read the results.
- Running tests locally with the CLI tool
Install the Guardian CLI, sign in with guardian login, run a test plan against a server on your own machine or network, and upload the result to your test history.
Samurai Security
- What security tests do
What Samurai Security's live security test checks on your own MCP server, who can run it, what you need first, and how Guardian keeps it safe.
- Run security tests
Run Samurai Security's live security test on a saved server from the web app or the Guardian CLI, and read the results and severities.
Samurai Compliance
- What Samurai Compliance is
What the Compliance Evidence Report is, which evidence Samurai Compliance pulls together, and who can see it.
- Use Samurai Compliance
Review control status, answer the self-attested questions, generate a Compliance Report for an audience, open past reports and export them.
Guardian CLI tool
- Quick Start
Install the Guardian CLI, sign in to get your token, and run your first test, with copy-ready commands for macOS, Windows and Linux.
- Upgrade
Check your Guardian CLI version and upgrade to the latest signed release with guardian update, or with Homebrew or WinGet.
- Send an auth token
Send your MCP server's auth token to the server under test with guardian test or guardian scan, using --header-env (recommended) or --header.
- Setup Details
Create your account, add your first MCP server, run your first scan and test, and find your results on the dashboard.
Account
- Your account
See your company and plan, and choose the timezone dates are shown in.
- CLI tokens
Create, store and revoke the tokens the Guardian CLI and CI jobs use to act for your company.
- AI model
Choose whether AI Evaluation uses Guardian's platform model or your own model and API key, and what is sent to your provider.