Skip to main content

MCP server for suss. scam detection and trust intelligence

Project description

suss-mcp

MCP server for suss. 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):

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

Claude Code

claude mcp add suss -- uvx suss-mcp

Manual install

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

suss_mcp-0.1.0.tar.gz (8.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

suss_mcp-0.1.0-py3-none-any.whl (9.3 kB view details)

Uploaded Python 3

File details

Details for the file suss_mcp-0.1.0.tar.gz.

File metadata

  • Download URL: suss_mcp-0.1.0.tar.gz
  • Upload date:
  • Size: 8.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.6

File hashes

Hashes for suss_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 f54da0827eb90776c778527da52abb78606f032f18470dcc92daea9127459846
MD5 02f59c63f10d1a2d8a412a38c0264f08
BLAKE2b-256 a1bced8ee69baeace8655dbdf1f97aa087fc07294317ddb1263fff62e78e73d5

See more details on using hashes here.

File details

Details for the file suss_mcp-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: suss_mcp-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 9.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.6

File hashes

Hashes for suss_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 aef8b44f6f3721e23d8c13121611d26b21b305ba95107d85a6baaeaa4cde8a20
MD5 b17dca05b2c239f0792b498ea63a2d60
BLAKE2b-256 de0efdb1864227db5a65046d2b2d40dd85085ba859c302ee81c4c5d98d253242

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page