Skip to main content

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.

Metadata

Release files for relayshield-mcp 0.2.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for relayshield-mcp 0.2.6
File Size Uploaded
relayshield_mcp-0.2.6.tar.gz 8.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for relayshield-mcp 0.2.6
File Interpreter ABI Platform
relayshield_mcp-0.2.6-py3-none-any.whl Python 3 none any Details

Total release size: 18.0 kB

Release files / relayshield_mcp-0.2.6.tar.gz

Download URL relayshield_mcp-0.2.6.tar.gz
Size 8.9 kB
Tags Source
SHA-256 checksum
How to use checksums
a42a15f4d049a797a5b2b2a80112074479a8167573be3db12ed0eb064dc7ab98
BLAKE2b-256 checksum
How to use checksums
c1f0a4dc895fb60ceb0dc42e74e0f881611fab03ae9a1eaf4d0f16e0a704b93f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 7, 2026.

Transparency log

Release files / relayshield_mcp-0.2.6-py3-none-any.whl

Download URL relayshield_mcp-0.2.6-py3-none-any.whl
Size 9.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4787fcda74496519227d5e1b16b7884043bf35f7ef69e7c805e8ceb725ea0b45
BLAKE2b-256 checksum
How to use checksums
74f6ed0cfbc3d46bd1ad1ba183707faf2f0dadfece67aed9777b275c74786bca
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 7, 2026.

Transparency log

Release history Release notifications | RSS feed

0.3.0

2 release files

0.2.9

2 release files

0.2.8

2 release files

0.2.7

2 release files

This release

0.2.6 This release

2 release files

0.2.5

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page