Agent Usage

Agent Usage

The MCPShield agent is a Python CLI tool that scans your machine for MCP server configurations and reports them to the central dashboard.

Installation

cd agent
pip install -e .

Commands

Configure

Set up the agent with your API key from the dashboard:

mcpshield configure --api-key mcp_sk_YOUR_KEY --api-url http://localhost:8000

Scan

Scan for MCP servers and report to the backend:

mcpshield scan

Dry Run

Scan without sending data to the backend:

mcpshield scan --dry-run

Status

Check agent configuration status:

mcpshield status

List

List discovered servers locally:

mcpshield list

Configuration File Locations

OS	Path
Windows	%LOCALAPPDATA%\MCPShield\config.json
macOS	~/Library/Application Support/MCPShield/config.json
Linux	~/.config/mcpshield/config.json

Scanned MCP Locations

The agent scans these paths for MCP configurations:

Windows

• %APPDATA%\Claude\claude_desktop_config.json
• %APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
• %APPDATA%\Windsurf\mcp_settings.json

macOS

• ~/Library/Application Support/Claude/claude_desktop_config.json

Linux

• ~/.config/Claude/claude_desktop_config.json
• ~/.config/cursor/mcp.json

Example Output

MCP Servers Found:
┌────────────┬─────────────────────────────────────────┬────────┬───────┐
│ Name       │ Type                                    │ Risk   │ Score │
├────────────┼─────────────────────────────────────────┼────────┼───────┤
│ filesystem │ @modelcontextprotocol/server-filesystem │ medium │ 35    │
│ postgres   │ unknown                                 │ medium │ 35    │
│ github     │ @modelcontextprotocol/server-github     │ low    │ 15    │
└────────────┴─────────────────────────────────────────┴────────┴───────┘