Skip to main content

MCP server for RelayShield — breach detection, SIM swap, domain lookalikes, OAuth watchlist, infostealer detection, URL/file scanning, MCP registry risk, and prompt-injection breach detection. Subscription (RapidAPI) and pay-as-you-go (x402 USDC on Base) access modes.

Project description

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-app breach + stolen-token exposure via HIBP + stealer-log corpus $0.30 USDC
check_infostealer Infostealer malware log lookup via Hudson Rock Cavalier $0.15 USDC
scan_wallet EVM wallet on-chain risk check via GoPlus Security $0.10 USDC
scan_url URL malware/phishing scan across 70+ engines (async) $0.05 USDC
scan_file Binary malware scan across 70+ AV engines (async) $0.10 USDC
check_scan_result Poll for verdict after scan_url / scan_file free
check_mcp_registry_risk Typosquat/IOC/registration-age check for MCP servers $0.35 USDC
check_prompt_injection_breach Breach exposure sourced from AI-agent prompt-injection attacks $0.35 USDC
check_supply_chain Up to 10 vendor domains checked for breach/infostealer exposure $0.10 USDC
check_session_risk Active/reusable stolen session (cookie/token) exposure check $0.30 USDC
check_nhi_exposure Non-human-identity credential exposure — API keys, service tokens, PATs $0.40 USDC
check_secret_scan Secrets exposed in public GitHub/GitLab repositories $0.35 USDC

check_oauth_watchlist, check_supply_chain, check_session_risk, check_nhi_exposure, and check_secret_scan cover related ground — connected-app, session, and machine-credential exposure for an identity or its supply chain — and are a natural set to use together when vetting an agent's current authority, not just a login.

Access modes

Subscription — API key from RapidAPI. All 15 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. All 15 tools available ($0.05–$0.50/check, check_scan_result free). 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://atq6wtkp6k.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://atq6wtkp6k.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://atq6wtkp6k.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

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.2.7.tar.gz (12.7 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.2.7-py3-none-any.whl (10.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: relayshield_mcp-0.2.7.tar.gz
  • Upload date:
  • Size: 12.7 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.2.7.tar.gz
Algorithm Hash digest
SHA256 164229c93be553de3dcb4a38a8cb01f0b27ad8ce51395690ed3a2593c7a43e17
MD5 4f4200d5bb29dd6646ff0744db103b8d
BLAKE2b-256 f385828c9f7bcdd94cb39cf51f5535b2a907b0387406f53c6f44e5e1e8e5fda7

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for relayshield_mcp-0.2.7-py3-none-any.whl
Algorithm Hash digest
SHA256 3ecbb70080649af98af6139640d8d5b1f12d9a3aced5a18f2695acc773d8a6ab
MD5 2f019712d4881dc197e14616e55588f2
BLAKE2b-256 56598a1a92f66eb79762ac682f0ff25408e306a064f6d82019e98726abde8683

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