# mcp-shield

**Category:** 🔒 Security  
**Repository:** https://github.com/cybercraftsolutionsllc/trust-gated-agent-example  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/mcp-shield

## Description
Trust verification for MCP servers. Check scores, scan for security issues, search 4,200+ servers.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "mcp-shield": {
    "command": "npx",
    "args": ["-y","mcp-shield"]
  }
}
```

## Documentation & README

# Trust-Gated Agent Examples

Reference implementations showing how to make AI agents check [CraftedTrust](https://mcp.craftedtrust.com) before connecting to any MCP server. If a server scores D or F, the agent refuses to connect.

This is the "SSL certificate check for AI agents" pattern.

## Quick Start

Add CraftedTrust to your agent's MCP config:

```json
{
  "mcpServers": {
    "craftedtrust": {
      "url": "https://mcp.craftedtrust.com/api/v1/mcp",
      "description": "Check trust scores before connecting to MCP servers"
    }
  }
}
```

Your agent now has access to 6 tools:

| Tool | Description |
|---|---|
| `check_trust` | Look up trust score by URL or npm name |
| `scan_server` | Trigger a live security scan |
| `search_registry` | Search 4,200+ indexed MCP servers |
| `get_stats` | Ecosystem statistics |
| `pay_for_certification` | Initiate USDC certification payment |
| `verify_payment` | Verify on-chain payment |

## The Pattern

Before your agent connects to any new MCP server:

1. Call `check_trust` on CraftedTrust
2. If grade is D or F, refuse and explain why
3. If grade is A/B/C, proceed with the connection

## Examples

### Python (LangGraph)

See [`python/trust_gated_agent.py`](python/trust_gated_agent.py) for a complete LangGraph agent that gates MCP connections through CraftedTrust.

```bash
cd python
pip install -r requirements.txt
python trust_gated_agent.py
```

### TypeScript (MCP Client)

See [`typescript/trust-gated-client.ts`](typescript/trust-gated-client.ts) for a TypeScript MCP client that checks trust scores before connecting.

```bash
cd typescript
npm install
npx tsx trust-gated-client.ts
```

## How It Works

```
Agent receives task → needs mcp.example.com
         ↓
Agent calls CraftedTrust check_trust("mcp.example.com")
         ↓
Score: 82/100, Grade: B ← Safe
         ↓
Agent connects to mcp.example.com ✓
```

```
Agent receives task → needs sketchy-server.xyz
         ↓
Agent calls CraftedTrust check_trust("sketchy-server.xyz")
         ↓
Score: 15/100, Grade: F ← Dangerous
         ↓
Agent refuses: "Server scored F (15/100). Not connecting." ✗
```

## Trust Score Grades

| Grade | Score | Meaning |
|---|---|---|
| A | 90-100 | Excellent security practices |
| B | 75-89 | Good security, minor improvements possible |
| C | 60-74 | Adequate but has gaps |
| D | 40-59 | Significant security issues |
| F | 0-39 | Critical issues, do not connect |

## API Reference

Full API documentation: [mcp.craftedtrust.com/api-docs.html](https://mcp.craftedtrust.com/api-docs.html)

## License

MIT

---

Built by [Cyber Craft Solutions LLC](https://craftedtrust.com)