relayshield-mcp
OfficialRelayShield-MCP is a security intelligence server that brings breach detection, threat scanning, and identity risk tools into Claude and other MCP-compatible AI agents. It offers the following capabilities:
Email Breach Lookup (
check_breach): Check if an email appears in 13 billion+ compromised accounts via Have I Been Pwned, returning breach count and details.SIM Swap Detection (
check_sim_swap): Detect SIM swap or eSIM provisioning events on a phone number in the last 24 hours using live carrier data.Domain Lookalike Monitoring (
check_domain_lookalikes): Identify typosquat and lookalike domains impersonating a brand via DNS resolution and Certificate Transparency data.OAuth Supply Chain Watchlist (
check_oauth_watchlist): Check if high-risk OAuth-connected SaaS apps (Slack, GitHub, Notion, etc.) tied to an email have appeared in recent breaches.Infostealer Log Lookup (
check_infostealer): Check if an email appears in infostealer malware logs (RedLine, Raccoon, Vidar, etc.).EVM Wallet Risk Scan (
scan_wallet): Assess an Ethereum/EVM wallet for on-chain risk signals like blacklisting and phishing associations via GoPlus Security.URL Malware/Phishing Scan (
scan_url): Submit a URL for async analysis across 70+ security engines.File Malware Scan (
scan_file): Submit a publicly accessible file URL for async binary malware analysis across 70+ AV engines.Scan Result Polling (
check_scan_result): Retrieve the verdict (malicious, suspicious, clean, or timeout) for a previously submitted URL or file scan (free tool).MCP Registry Risk Check (
check_mcp_registry_risk): Check an MCP server URL or package name for known-malicious indicators, typosquats, and domain registration age before connecting.Prompt Injection Breach Check (
check_prompt_injection_breach): Detect email exposure in breach dumps linked to AI agent prompt-injection attacks.Supply Chain Exposure (
check_supply_chain): Analyze up to 10 vendor domains for breach or infostealer exposure.Session Risk Check (
check_session_risk): Detect active or reusable stolen session cookies/tokens tied to an identity.Non-Human Identity (NHI) Exposure (
check_nhi_exposure): Find exposed API keys, service tokens, and PATs associated with an identity.Secret Scanning (
check_secret_scan): Discover secrets exposed in public GitHub/GitLab repositories.
All tools are accessible via RELAYSHIELD_API_KEY (subscription) or RELAYSHIELD_X_PAYMENT (pay-as-you-go).
Check if GitHub OAuth apps connected to a user's email have been involved in known security breaches.
Check if Notion OAuth apps connected to a user's email have been involved in known security breaches.
Check if Slack OAuth apps connected to a user's email have been involved in known security breaches.
Check if Zapier OAuth apps connected to a user's email have been involved in known security breaches.
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 |
| Email breach lookup — 13 billion+ compromised-account records | $0.10 USDC |
| SIM swap / eSIM detection via live carrier data | $0.25 USDC |
| Typosquat and lookalike domain detection with cert transparency | $0.50 USDC |
| OAuth-app breach + stolen-token exposure from the stealer-log corpus | $0.30 USDC |
| Infostealer malware log lookup — credentials harvested from infected devices | $0.15 USDC |
| EVM wallet on-chain risk check | $0.10 USDC |
| URL malware/phishing scan across 70+ engines (async) | $0.05 USDC |
| Binary malware scan across 70+ AV engines (async) | $0.10 USDC |
| Poll for verdict after | free |
| Typosquat/IOC/registration-age check for MCP servers | $0.35 USDC |
| Breach exposure sourced from AI-agent prompt-injection attacks | $0.35 USDC |
| Up to 10 vendor domains checked for breach/infostealer exposure | $0.10 USDC |
| Active/reusable stolen session (cookie/token) exposure check | $0.30 USDC |
| Non-human-identity credential exposure — API keys, service tokens, PATs | $0.40 USDC |
| Secrets exposed in public GitHub 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.
Related MCP server: Nullcone MCP Server
Access modes
Subscription — API key from api.relayshield.net/developers. 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-mcpOr run without installing:
uvx relayshield-mcpConfigure Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
Subscription (RelayShield API key):
{
"mcpServers": {
"relayshield": {
"command": "relayshield-mcp",
"env": {
"RELAYSHIELD_API_URL": "https://api.relayshield.net",
"RELAYSHIELD_API_KEY": "your-relayshield-api-key-here"
}
}
}
}Pay-as-you-go (x402 USDC on Base):
{
"mcpServers": {
"relayshield": {
"command": "relayshield-mcp",
"env": {
"RELAYSHIELD_API_URL": "https://api.relayshield.net",
"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://api.relayshield.net \
--env RELAYSHIELD_API_KEY=your-relayshield-api-key-hereFree checks server (no key, no signup)
relayshield-free-mcp ships in the same package and exposes RelayShield's free,
keyless threat-intel checks as four MCP tools. It is the funnel into the paid
server above: every summary links the deeper paid checks where they apply.
Tool | What it does | Key needed |
| Screen 1–25 URLs for phishing/malware (IOC corpus + threat feeds + domain age) | no |
| Screen a crypto wallet before paying it (chain auto-detected) | no |
| Score a suspicious email for phishing signals; checks its links too | no |
| Email vs 13B+ breached accounts | partner key only |
pip install relayshield-mcp
# or: uvx relayshield-mcp
relayshield-free-mcpClaude Desktop — add to claude_desktop_config.json:
{
"mcpServers": {
"relayshield-free": {
"command": "relayshield-free-mcp",
"env": {
"RELAYSHIELD_API_URL": "https://api.relayshield.net",
"RS_SOURCE_TAG": "mcp-free-claude"
}
}
}
}ChatGPT — ChatGPT connects to MCP servers through Developer Mode
connectors, which require a remote HTTP endpoint; it does not launch a local
stdio server. A hosted RelayShield MCP endpoint is planned — until then, use
Claude Desktop, Claude Code, Cursor, or any other stdio-capable MCP client.
Set RS_SOURCE_TAG=mcp-free-chatgpt once the hosted endpoint is live so usage
is attributed to the ChatGPT channel. check_breach stays disabled until a
partner key is set via RELAYSHIELD_API_KEY.
Partner keys — distributors (Claude, ChatGPT, registries) each get their own
RelayShield partner key with a per-key daily call cap, set via
RELAYSHIELD_API_KEY. Separate keys per channel mean one channel's abuse never
takes down the others, and RS_SOURCE_TAG attributes usage per channel. The
server runs fine without any key — link, wallet, and email checks stay keyless
on the free tier.
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.comFor URL and file scans, Claude automatically polls check_scan_result every 5 seconds until the verdict is ready.
Environment variables
Variable | Description |
| API Gateway base URL (required) |
| RelayShield subscription key (subscription mode) — get one at api.relayshield.net/developers |
| 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
Telegram bot / miniApp — free scam checks in chat
WhatsApp scam-check bot — message a link, wallet, or email
Available Tools
11 toolscheck_breachA
Check whether an email address appears in known data breaches. Uses Have I Been Pwned (HIBP) — 13 billion+ compromised accounts. Returns breach count and details (breach name, date, exposed data classes). Use before allowing high-risk actions that depend on credential integrity. Pay-as-you-go: $0.10 USDC per check (x402 on Base). Subscription: rapidapi.com/relayshield
Inputs: email (required).
check_domain_lookalikesA
Detect typosquat and lookalike domains impersonating a brand. Generates hundreds of permutations (TLD swaps, character typos, homoglyphs, phishing prefixes/suffixes), resolves them in parallel via DNS, and enriches live results with Certificate Transparency data (cert count, recent issuance). Returns all lookalike domains that are currently registered and resolving. Use to find domains impersonating your brand, or before an employee clicks a link that resembles a company domain. Pay-as-you-go: $0.50 USDC per scan (x402 on Base). Subscription: rapidapi.com/relayshield
Inputs: domain (required).
check_infostealerA
Check whether an email address appears in infostealer malware logs. Uses Hudson Rock Cavalier — a database of credentials harvested directly from infected computers by infostealer malware (RedLine, Raccoon, Vidar, etc.). Returns found (bool), stealer count, and per-infection details: date compromised, operating system, malware path, and number of corporate/personal credentials stolen. Unlike breach databases (HIBP), infostealer hits mean the device itself was compromised — all stored passwords, session cookies, and crypto keys are at risk. Pay-as-you-go: $0.15 USDC per check (x402 on Base). Subscription: rapidapi.com/relayshield
Inputs: email (required).
check_mcp_registry_riskA
Check an MCP server URL or package name for red flags: known-malicious IOC match, typosquat/near-miss against well-known MCP ecosystem domains, and domain registration age. Part of RelayShield's Agentic Attack Surface bundle — early coverage for an ecosystem with minimal dedicated security tooling as of 2026. Use before an agent connects to or installs a new, unfamiliar MCP server. Absence of findings means 'unknown,' not 'verified safe.' Pay-as-you-go: $0.35 USDC per check (x402 on Base). Subscription: rapidapi.com/relayshield
Inputs: server_url, package_name.
check_oauth_watchlistA
Check whether any high-risk OAuth-capable SaaS apps connected to an email account have appeared in recent data breaches. Monitors a curated watchlist of apps (Slack, Notion, GitHub, Zapier, Vercel, Loom, HubSpot, AI tools, and more). An attacker who breaches these services may obtain OAuth tokens granting access to your Google Workspace or Microsoft 365 without touching your password. Returns matched breached apps and recommended revocation steps. Pay-as-you-go: $0.15 USDC per check (x402 on Base). Subscription: rapidapi.com/relayshield
Inputs: email (required).
check_prompt_injection_breachA
Check whether an email address has exposure in a criminal dump whose own announcement text suggests an AI agent — rather than a traditional phishing or malware campaign — was involved in obtaining it. Heuristic v1 classifier over Telegram dump-announcement text, not a confirmed-attribution guarantee. Use as an early signal that an AI agent workflow may have been the breach vector. Pay-as-you-go: $0.35 USDC per check (x402 on Base). Subscription: rapidapi.com/relayshield
Inputs: email (required).
check_scan_resultA
Poll for the result of a previously submitted URL or file scan. Call every 5 seconds after scan_url or scan_file until status is 'completed'. Returns verdict (malicious/suspicious/clean) and engine vote counts, or {status: pending} if the scan is still running. Free with a paid scan (no additional charge).
Inputs: analysis_id (required).
check_sim_swapA
Detect whether a SIM swap or eSIM provisioning event has occurred on a phone number in the last 24 hours. Uses Twilio Lookup v2 with live carrier data. Returns swapped (bool), swap timestamp, and current carrier. Use when a user reports losing mobile service, or before completing a high-risk action that depends on SMS-based authentication. Pay-as-you-go: $0.25 USDC per check (x402 on Base). Subscription: rapidapi.com/relayshield
Inputs: phone (required).
scan_fileA
Submit a file for binary malware analysis across 70+ AV engines. Provide a publicly accessible download URL — RelayShield handles the download. Returns an analysis_id immediately (async). Call check_scan_result with the analysis_id every 5 seconds until verdict is returned. Verdicts: malicious | suspicious | clean | timeout. Use when a user receives an email attachment and forwards the download link. Pay-as-you-go: $0.10 USDC per scan (x402 on Base). Subscription: rapidapi.com/relayshield
Inputs: file_url (required), filename.
scan_urlA
Submit a URL for malware and phishing analysis across 70+ security engines. Returns an analysis_id immediately (async). Call check_scan_result with the analysis_id every 5 seconds until verdict is returned. Verdicts: malicious | suspicious | clean | timeout. Use before navigating to an unfamiliar URL or when a user forwards a suspicious link. Pay-as-you-go: $0.05 USDC per scan (x402 on Base). Subscription: rapidapi.com/relayshield
Inputs: url (required).
scan_walletA
Check an EVM wallet address for on-chain risk signals using GoPlus Security. Detects blacklisted addresses, contract risk flags, malicious activity, phishing associations, and other on-chain threat indicators. Returns risk_level (LOW/MEDIUM/HIGH), risk_flags list, and raw GoPlus data. Supports Ethereum mainnet (default) and other EVM chains via chain_id. Use before sending funds to an unknown address or in DeFi due-diligence flows. Pay-as-you-go: $0.10 USDC per scan (x402 on Base). Subscription: rapidapi.com/relayshield
Inputs: address (required), chain_id.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Each tool targets a distinct risk surface (phone, email, URL/file, wallet, MCP, domains), and the async scan tools have a clear poller companion. The only real ambiguity is among check_breach, check_infostealer, and check_prompt_injection_breach, which all take an email address but are differentiated by data source.
The set follows a consistent check_/scan_ + target convention, and check_scan_result clearly pairs with scan_url/scan_file. scan_wallet and check_domain_lookalikes deviate slightly from the expected direct-check naming, but the pattern remains predictable.
Eleven tools is a reasonable size for a security-checking server covering phone, email, URLs, files, wallets, MCP servers, and domains. Each tool represents a distinct check or required polling helper, with no obvious filler.
The surface covers the main security-check workflows end to end, including async URL/file scans paired with check_scan_result. Minor gaps exist (e.g., general domain reputation checking or historical result retrieval), but they do not create dead ends for the stated purpose.
Maintenance
Related MCP Connectors
Pay-per-call cybersecurity for AI agents: vuln scans, threat intel, compliance, code security.
Security intelligence for AI agents. 27 x402 endpoints: honeypot, forensics, CAPTCHA, preflight.
OT/ICS threat intel for AI agents: 40 tools, pay per call in USDC on Base via x402.
Pay-per-call safety checks for AI agents: screen a crypto address or URL before you transact.
Related MCP Servers
- AlicenseAqualityDmaintenancesecurity tools for AI agents: URL safety scanning, prompt injection detection (200+ patterns), email/password breach checks via HIBP, domain & IP reputation analysis, and AI skill supply chain scanning. Free tier (3 calls/day) or pay-per-request with USDC micropayments via x402.932 npm1MIT
- FlicenseNot gradedqualityDmaintenanceProvides real-time threat intelligence for AI agents, enabling checks on IPs, domains, URLs, hashes, CVEs, prompt-injection payloads, and malicious AI-skill/MCP-tool definitions against a free database of 890K+ IOCs.-
- FlicenseNot gradedqualityDmaintenance53 security & enrichment MCP tools for AI agents. Contract scanning, threat intel, OSINT, crypto data, DNS/WAF recon. Pay-per-call via HTTP 402 + USDC on Base mainnet. No API keys. First call free.-
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to perform pay-per-call security verification of wallets, tokens, contracts, dApps, agents, and more via a remote endpoint with no installation.2MIT