AgentShield MCP Inspector Lite
In one line: This server lets you submit MCP tool metadata for basic, non-executing security inspection and get back an explainable risk verdict.
Analyze MCP tools via the single
analyze_toolstool, which accepts an array of tool definitions (each requiring aname, with optionaldescriptionandinputSchema).Inspect tool names, descriptions, and JSON Schemas for high-risk capability signals — shell/OS command execution, destructive file operations, filesystem reads, external network access, and secrets/credential access.
Produce verdicts of
SAFE,REVIEW, orHIGH RISKwith supporting evidence explaining the reasoning.Run safely — target tools are never executed; analysis is static metadata/schema inspection only.
Use it for a first-pass check on an MCP tool surface before deeper review or trust decisions (verdicts are signals, not proof).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@AgentShield MCP Inspector Lite Analyze these MCP tool definitions and flag any high-risk ones."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🛡️ AgentShield MCP Inspector Lite
A TYKAIRO AI product — Founded by Mahmoud Hisham
Free, local-first MCP security inspection for tool metadata, schemas, and high-risk capabilities.
AgentShield MCP Inspector Lite analyzes MCP tool names, descriptions, and input schemas and returns explainable verdicts:
SAFEREVIEWHIGH RISK
The goal is simple: inspect an MCP tool surface before trusting it.
AgentShield is a risk-inspection tool. A verdict is not proof that software is safe or malicious.
⚡ Quick start
git clone https://github.com/TYKAIRO-AI/AgentShield-MCP-Inspector.git
cd AgentShield-MCP-Inspector
npm install
npm test
npm run scan:sampleScan your own MCP tool metadata from JSON:
node src/cli.js scan-json examples/sample-tools.json --md-out report.md --json-out report.jsonOr run Lite as an MCP server:
node src/index.jsThe server exposes the analyze_tools tool.
Related MCP server: sentinel-scan
What Lite does
The starter ruleset looks for signals related to:
Shell / OS command execution
Destructive file operations
Filesystem reads
External network access
Secrets / credential access
It supports both static JSON scanning and MCP-server use.
Example workflow
MCP tool metadata
↓
AgentShield Lite
↓
Capability + schema inspection
↓
SAFE / REVIEW / HIGH RISK
↓
Evidence explaining whyThis makes it useful for developers, MCP publishers, reviewers, and teams that want a quick first-pass security check before deeper inspection.
Lite vs Pro
Lite is intentionally focused and public. AgentShield Pro is developed separately and is not included in this repository.
Planned Pro capabilities include:
Direct stdio MCP discovery
Expanded security rules
Allowlist / blocklist policy files
Trusted-domain policy
Better network classification
CI/CD exit codes and security gates
Scan history and scan diff
SARIF / advanced reporting
Source and package inspection
Remote MCP scanning
Advanced evidence and policy controls
Project status
Edition: Lite
Version: 0.1.0-lite.1
Runtime: Node.js 20+
Issues and feature ideas are welcome. If this project helps you evaluate MCP tools, consider starring the repository so more developers can discover it.
Contributing
See CONTRIBUTING.md.
Security
For security-related reports, see SECURITY.md.
Ownership
Publisher: Mahmoud Hisham
Organization: TYKAIRO AI
Copyright © 2026 Mahmoud Hisham. All rights reserved. See LICENSE.txt.
Available Tools
1 toolanalyze_toolsAnalyze MCP tool metadataB
Basic Lite-edition inspection of MCP tool names, descriptions and JSON Schemas without executing target tools.
Inputs: tools (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
Only one tool exists, so there is zero risk of an agent confusing it with another. The tool's purpose is clearly defined.
The single tool uses a clear verb_noun pattern ('analyze_tools'), and with only one name there is no inconsistency to evaluate.
A single tool is at the lower boundary of acceptable scope. It may be intentional for a 'Lite' edition, but the set feels very thin.
The tool covers the core inspection task (names, descriptions, schemas) without execution, but lacks any auxiliary operations like listing, comparing, or exporting results—though these may be outside the Lite scope.
Maintenance
Related MCP Connectors
Find, vet, and run MCP tools through a secure audited gateway with prompt-injection risk scoring
Security & DLP proxy for MCP: tool-poisoning scans, PII redaction on tool args/results. Beta.
Statically audits MCP tool surfaces for token cost, schema quality, and design issues.
Scan any MCP server for tool-poisoning, security, auth & license. Trust score before install.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenancePerforms explainable, deterministic static analysis of MCP tool metadata to detect misleading instructions, concealed capabilities, and schema drift without executing tools.1MIT
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients to scan tool manifests and server configs for prompt injection, tool poisoning, excessive agency, and other OWASP-mapped security issues directly through the scan_mcp_manifest tool.83 npm3MIT
- FlicenseNot gradedqualityCmaintenanceEnables MCP tool calls with strict schema validation and stdio isolation, while providing a security gateway for tool-level authorization, streaming PII redaction, and model failover routing.-
- AlicenseNot gradedqualityCmaintenanceEnables users to audit other MCP servers' tool definitions for agentic attack classes such as tool poisoning, sensitive-path references in metadata, and tool shadowing via invisible Unicode or homoglyphs. It can analyze a tools/list payload, check a single description string, or connect to a public remote MCP URL to fetch and audit its tool list.MIT