Skip to main content
Glama
README.md
# Bridge Security MCP Server 🌉⚡

> **$2.8B stolen from bridges. Every L2 needs an auditor. Now it's an MCP server.**

Cross-chain bridge security auditing toolkit exposed as a Model Context Protocol (MCP) server. Connect any MCP client (Claude, Cursor, OpenClaw, etc.) and audit bridge contracts via natural language.

## What It Does

| Tool | What It Finds |
|------|---------------|
| `bridge_analyze` | Centralization risks, replay attacks, reentrancy, signature malleability, missing verification |
| `bridge_fuzz` | Message replay, ordering faults, timeout exploits, relayer failure, race conditions |
| `bridge_simulate_validators` | Byzantine faults, collusion, key compromise, offline validators, optimal thresholds |
| `bridge_track_supply` | Double mints, orphaned locks/mints, supply drift, missing burns |
| `bridge_generate_report` | Structured audit reports (standard, Immunefi, Code4rena templates) |

## Install

```bash
# Clone or pip install
pip install mcp-server-bridge-security
# OR
git clone https://github.com/manteclaw/mcp-server-bridge-security.git
cd mcp-server-bridge-security
pip install -r requirements.txt
```

## Connect

### Claude Desktop

Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "bridge-security": {
      "command": "python",
      "args": ["C:\\path\\to\\mcp-server-bridge-security\\server.py"]
    }
  }
}
```

### Cursor

Add to `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "bridge-security": {
      "command": "python",
      "args": ["/path/to/server.py"]
    }
  }
}
```

### OpenClaw

```bash
openclaw skill add projects/mcp-marketplace/mcp-server-bridge-security
```

## Usage Examples

Once connected, ask your AI agent:

> "Analyze this bridge contract for vulnerabilities: `contracts/ETNBridge.sol`"

> "Simulate a 5-validator bridge with 3-signature threshold and 1 Byzantine validator"

> "Fuzz this bridge for replay attacks and race conditions"

> "Track supply across chains for these bridge events and detect double mints"

> "Generate an Immunefi-style report from these findings"

## Pricing

| Tier | Price | Limits |
|------|-------|--------|
| Community | Free | 10 calls/day |
| Pro | $29/month | Unlimited calls |
| Enterprise | $199/month | Unlimited + custom chains + SLA |

## License

MIT — audit the bridges, earn the bounties, stay safe. ⚡

---

*Built by Manteclaw | Base L2 native | Protocol-native security tooling*