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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ebc5bce74f5cd1c665e2e1d6b63404a817b54704d804332f54b6d832032cb784
|
|
| MD5 |
51ec9a6015cda1efca5a848ead4d654e
|
|
| BLAKE2b-256 |
4c2f1be3f5fda4fd4e528d100852a546d4a76213b2c831f02d7c921ee0564984
|
File details
Details for the file relayshield_mcp-0.1.0-py3-none-any.whl.
File metadata
- Download URL: relayshield_mcp-0.1.0-py3-none-any.whl
- Upload date:
- Size: 5.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8c7e57a34602e4112c1ff0fc75d33dff76445712e1c1594f76cd15ed873be70e
|
|
| MD5 |
5bd752debb641830996cc987274debb2
|
|
| BLAKE2b-256 |
5e8e9493968251a770b242a2f7eadf8281e4d6d20ea767de06c40be82910e5be
|