relayshield-mcp
mcp-name: io.github.nzdsf2-gif/relayshield-mcp
RelayShield security intelligence as an MCP server — plug breach detection, SIM swap detection, domain lookalike monitoring, OAuth supply chain watchlist, and URL/file scanning directly into Claude and any MCP-compatible AI agent.
Tools
| Tool | What it does | PAYG price |
|---|---|---|
check_breach |
Email breach lookup — 13 billion+ records via HIBP | $0.10 USDC |
check_sim_swap |
SIM swap / eSIM detection via live carrier data | $0.25 USDC |
check_domain_lookalikes |
Typosquat and lookalike domain detection with cert transparency | $0.50 USDC |
check_oauth_watchlist |
OAuth supply chain breach check — Slack, GitHub, Notion, Zapier, and more | $0.15 USDC |
scan_url |
URL malware/phishing scan across 70+ engines (async) | subscription only |
scan_file |
Binary malware scan across 70+ AV engines (async) | subscription only |
check_scan_result |
Poll for verdict after scan_url / scan_file |
free |
Access modes
Subscription — API key from RapidAPI. All 7 tools available. Free tier: 100 calls/month. Paid tiers from $29/month.
Pay-as-you-go — No API key needed. Pay per check in USDC on Base (x402 protocol). Set RELAYSHIELD_X_PAYMENT with your payment proof. 4 tools available ($0.10–$0.50/check). Call a tool with no payment set to receive pricing and payment instructions.
Discovery — Set neither key nor payment. Tool calls return payment requirements and a subscription link.
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):
Subscription (RapidAPI key):
{
"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"
}
}
}
}
Pay-as-you-go (x402 USDC on Base):
{
"mcpServers": {
"relayshield": {
"command": "relayshield-mcp",
"env": {
"RELAYSHIELD_API_URL": "https://xhh3tfrhng.execute-api.us-east-1.amazonaws.com/prod",
"RELAYSHIELD_X_PAYMENT": "your-x402-payment-proof-here"
}
}
}
}
Quit and relaunch Claude Desktop after editing.
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.
Has there been a SIM swap on +14155551234?
Check acme.com for lookalike domains.
Are any OAuth apps connected to user@example.com in a recent breach?
Scan this URL for malware: https://suspicious-link.example.com
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 (required) |
RELAYSHIELD_API_KEY |
RapidAPI subscription key (subscription mode) |
RELAYSHIELD_X_PAYMENT |
x402 payment proof — USDC on Base (pay-as-you-go mode) |
Set RELAYSHIELD_API_KEY or RELAYSHIELD_X_PAYMENT — not both. API key takes priority if both are set.
Links
Metadata
Release files for relayshield-mcp 0.2.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| relayshield_mcp-0.2.2.tar.gz | 7.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| relayshield_mcp-0.2.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 15.9 kB
Release files / relayshield_mcp-0.2.2.tar.gz
| Download URL | relayshield_mcp-0.2.2.tar.gz |
|---|---|
| Size | 7.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4820fc3aa9e3efbd0995d0d1281c66edc8329201745c19a295600fc319234b90
|
|
BLAKE2b-256 checksum How to use checksums |
9d3f9b4f16d78b0bdcb9134353f7e75086af72c67db31f32970399f390298752
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.5
|
Release files / relayshield_mcp-0.2.2-py3-none-any.whl
| Download URL | relayshield_mcp-0.2.2-py3-none-any.whl |
|---|---|
| Size | 8.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
64ad19ca4721903dcbf3e91b22853d3571651e021b4b7f63a1bdb9716b438342
|
|
BLAKE2b-256 checksum How to use checksums |
dda3cb905ab56aae4a7ed2128a5790facb4e2b5310fbdfc7dc5121e817af2edf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.5
|