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 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

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.6.tar.gz (8.9 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.6-py3-none-any.whl (9.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: relayshield_mcp-0.2.6.tar.gz
  • Upload date:
  • Size: 8.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for relayshield_mcp-0.2.6.tar.gz
Algorithm Hash digest
SHA256 a42a15f4d049a797a5b2b2a80112074479a8167573be3db12ed0eb064dc7ab98
MD5 d2b323b129975aa12459b8876148f251
BLAKE2b-256 c1f0a4dc895fb60ceb0dc42e74e0f881611fab03ae9a1eaf4d0f16e0a704b93f

See more details on using hashes here.

Provenance

The following attestation bundles were made for relayshield_mcp-0.2.6.tar.gz:

Publisher: publish.yml on relayshield/relayshield-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

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

File metadata

File hashes

Hashes for relayshield_mcp-0.2.6-py3-none-any.whl
Algorithm Hash digest
SHA256 4787fcda74496519227d5e1b16b7884043bf35f7ef69e7c805e8ceb725ea0b45
MD5 9d71e7102238e9e69480287a9fab0e86
BLAKE2b-256 74f6ed0cfbc3d46bd1ad1ba183707faf2f0dadfece67aed9777b275c74786bca

See more details on using hashes here.

Provenance

The following attestation bundles were made for relayshield_mcp-0.2.6-py3-none-any.whl:

Publisher: publish.yml on relayshield/relayshield-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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