Skip to main content

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

Metadata

Release files for suss-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for suss-mcp 0.1.0
File Size Uploaded Provenance
suss_mcp-0.1.0.tar.gz 8.0 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for suss-mcp 0.1.0
File Interpreter ABI Platform
suss_mcp-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 17.3 kB

Release files / suss_mcp-0.1.0.tar.gz

Download URL suss_mcp-0.1.0.tar.gz
Size 8.0 kB
Tags Source
SHA-256 checksum
How to use checksums
f54da0827eb90776c778527da52abb78606f032f18470dcc92daea9127459846
BLAKE2b-256 checksum
How to use checksums
a1bced8ee69baeace8655dbdf1f97aa087fc07294317ddb1263fff62e78e73d5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.6

Release files / suss_mcp-0.1.0-py3-none-any.whl

Download URL suss_mcp-0.1.0-py3-none-any.whl
Size 9.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
aef8b44f6f3721e23d8c13121611d26b21b305ba95107d85a6baaeaa4cde8a20
BLAKE2b-256 checksum
How to use checksums
de0efdb1864227db5a65046d2b2d40dd85085ba859c302ee81c4c5d98d253242
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.6

Security for suss-mcp 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page