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.