Skip to main content

MCP server for RelayShield — breach detection, URL/file scanning, SIM swap detection, and domain lookalike monitoring

Project description

relayshield-mcp

RelayShield security intelligence as an MCP server — plug breach detection, URL/file scanning, SIM swap detection, and domain lookalike monitoring directly into Claude and any MCP-compatible AI agent.

Tools

Tool What it does
check_breach Email breach lookup — 13 billion+ records via HIBP
scan_url URL malware/phishing scan across 70+ engines (async)
scan_file Binary malware scan across 70+ AV engines (async)
check_scan_result Poll for verdict after scan_url / scan_file
check_sim_swap SIM swap / eSIM detection via live carrier data
check_domain_lookalikes Typosquat and lookalike domain detection with cert transparency

Get an API key

Sign up at RapidAPI — RelayShield Security Intelligence.

Free tier: 100 calls/month. Paid tiers start at $29/month.

Install

pip install relayshield-mcp

Or run without installing:

uvx relayshield-mcp

Configure Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "relayshield": {
      "command": "relayshield-mcp",
      "env": {
        "RELAYSHIELD_API_URL": "https://xhh3tfrhng.execute-api.us-east-1.amazonaws.com/prod",
        "RELAYSHIELD_API_KEY": "your-rapidapi-key-here"
      }
    }
  }
}

Quit and relaunch Claude Desktop. The hammer icon in the bottom-left will show all 6 RelayShield tools.

Configure Claude Code (CLI)

claude mcp add relayshield \
  --command relayshield-mcp \
  --env RELAYSHIELD_API_URL=https://xhh3tfrhng.execute-api.us-east-1.amazonaws.com/prod \
  --env RELAYSHIELD_API_KEY=your-rapidapi-key-here

Usage examples

Once configured, ask Claude:

Check whether user@example.com has been breached.
Scan this URL for malware: https://suspicious-link.example.com
Has there been a SIM swap on +14155551234?
Check acme.com for lookalike domains.

For URL and file scans, Claude automatically polls check_scan_result every 5 seconds until the verdict is ready.

Environment variables

Variable Description
RELAYSHIELD_API_URL API Gateway base URL (provided above)
RELAYSHIELD_API_KEY Your RapidAPI key for RelayShield

Links

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

relayshield_mcp-0.1.0.tar.gz (5.1 kB view details)

Uploaded Source

Built Distribution

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

relayshield_mcp-0.1.0-py3-none-any.whl (5.8 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for relayshield_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 ebc5bce74f5cd1c665e2e1d6b63404a817b54704d804332f54b6d832032cb784
MD5 51ec9a6015cda1efca5a848ead4d654e
BLAKE2b-256 4c2f1be3f5fda4fd4e528d100852a546d4a76213b2c831f02d7c921ee0564984

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for relayshield_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8c7e57a34602e4112c1ff0fc75d33dff76445712e1c1594f76cd15ed873be70e
MD5 5bd752debb641830996cc987274debb2
BLAKE2b-256 5e8e9493968251a770b242a2f7eadf8281e4d6d20ea767de06c40be82910e5be

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