# suss-mcp

MCP server for [suss.](https://suss.ai) scam detection and trust intelligence. Gives AI agents the ability to verify websites, scan messages for scams, and look up entities in the scam database.

## Quick Start

### Claude Desktop

Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "suss": {
      "command": "uvx",
      "args": ["suss-mcp"]
    }
  }
}
```

### Claude Code

```bash
claude mcp add suss -- uvx suss-mcp
```

### Manual install

```bash
pip install suss-mcp
suss-mcp  # starts stdio transport
```

## Tools

| Tool | Description | Example prompt |
|------|-------------|---------------|
| `check_trust` | Domain trust score + reputation signals | "Is nike.com legitimate?" |
| `scan_text` | Scan text for 367+ scam signals | "Is this email a scam? [paste]" |
| `scan_url` | URL + domain trust combined check | "Is this link safe? https://..." |
| `batch_trust` | Check up to 50 domains at once | "Compare these 5 stores" |
| `report_scam` | Submit feedback on false positives/negatives | "That result was wrong, report it" |
| `lookup_entity` | Check phone/email/crypto in scam database | "Has this number been reported?" |
| `verify` | Fast agent-optimized check (<200ms) | For automated/bulk verification |

## What it detects

- Phishing & credential theft
- Romance & pig butchering scams
- Job & employment fraud
- Crypto & investment scams
- Marketplace & P2P payment scams
- Tech support scams
- Identity theft attempts
- AI-powered scams (deepfakes, prompt injection)
- FAFSA & scholarship fraud
- Gaming & virtual item scams
- And 20+ more categories (367 signals total)

## Configuration

| Variable | Default | Description |
|----------|---------|-------------|
| `SUSS_API_URL` | `https://suss-api-....run.app` | API base URL |
| `SUSS_API_KEY` | _(none)_ | API key for authenticated access |

## API Tiers

- **Free:** 1,000 queries/month
- **Student:** Unlimited with `.edu` email
- **Starter:** $49/mo for 10K queries
- **Business:** $299/mo for 100K queries

## License

MIT
