mcpshield
MCPShield
Documentation
MCPShield CLI
Scan MCP servers and GitHub repositories for security vulnerabilities.
Powered by MCPShield — the MCP security scanner with 59+ detection rules covering the OWASP MCP Top 10.
Install
npm install -g mcpshieldSetup
Get a free API key at mcpshield.co/settings, then:
mcpshield auth mcp_sk_your_key_hereUsage
# Scan an HTTP MCP server
mcpshield scan --url https://mcp-server.example.com/mcp
# Scan a GitHub repository
mcpshield scan --github https://github.com/user/repo
# JSON output (for CI/CD)
mcpshield scan --url https://mcp-server.example.com/mcp --json
# Filter by severity
mcpshield scan --url https://mcp-server.example.com/mcp --severity highExit Codes
- `0` — Scan completed, no critical findings
- `1` — Error (invalid key, rate limit, scan failure)
- `2` — Scan completed with critical findings
Environment Variables
- `MCPSHIELD_API_KEY` — API key (alternative to `mcpshield auth`)
- `MCPSHIELD_API_URL` — Custom API endpoint (for self-hosted)
License
MIT
Frequently asked questions
What is mcpshield?
mcpshield is MCPShield
How do I install mcpshield?
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 mcpshield open source?
Yes — it is hosted on GitHub at https://github.com/MCPShield-Dev/mcpshield.
Related MCP tools
Model Context Protocol Servers
The Open-Source Multimodal AI Agent Stack: Connecting Cutting-Edge AI Models and Agent Infra
A MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you
MCP server to provide Figma layout information to AI coding agents like Cursor
The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.
Instant is the best backend for AI-coded apps. You get auth, permissions, storage, presence, and streams — everything you need to ship apps your users will love.
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP