Back to Directory/Communication

com.dechonet/mcp

23 security tools for AI agents: phishing links, exposure maps, DNS, SSL, PQC, headers, email.

CommunicationJavaScriptv1.3.1

DechoNet MCP Server

Domain security reconnaissance for AI agents via the Model Context Protocol.

19 tools, free, no API key. DNS, SSL/TLS, HTTP security headers, email authentication, port scan, DNS propagation, reverse DNS, ASN/BGP, RDAP/WHOIS, subdomain discovery (CT logs), lookalike/typosquat detection, OWASP-mapped observable checks, brand-impersonation exposure, go-live readiness, and domain change history — what changed since the last check.

Every result comes back interpreted, not just as raw JSON: a status, the key numbers, each issue with severity and confidence, and the concrete action to take. That is what an agent needs to tell a human what to do next.

Part of DechoNet. Every tool here is also a free web tool at dechonet.com — no sign-up — backed by error-fix guides. This package brings the same checks to AI agents.

Zero-install: remote endpoint

No npx, no install, no key. Point any MCP client that speaks Streamable HTTP at:

https://dechonet.com/mcp

Claude Desktop / Claude Code (claude mcp add --transport http dechonet https://dechonet.com/mcp), Cursor, and other HTTP-capable clients connect directly. The remote endpoint also serves 3 curated prompts (audit_domain, monitor_setup, investigate_changes) and 2 reference resources.

Quick Start (stdio, Claude Desktop)

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "dechonet": {
      "command": "npx",
      "args": ["-y", "dechonet-mcp"]
    }
  }
}

Config file location:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Restart Claude Desktop. You'll see the DechoNet tools icon in the input area.

Install

# Via npx (no install needed)
npx dechonet-mcp

# Or install globally
npm install -g dechonet-mcp

Available Tools

ToolDescription
security_scanComprehensive scan — 9 checks in parallel, 0-100 Health Score, A-F grade
dns_lookupDNS records + DNSSEC + SPF/DMARC validation
ssl_checkSSL/TLS certificate, chain, expiry, HSTS, CT history, A-F grade
http_securityHTTP redirect trace + 10 security headers audit, A-F grade
email_authSPF, DMARC, DKIM, BIMI, MTA-STS, DANE + blacklist check
port_scanOpen TCP ports with service identification
dns_propagationDNS propagation across 8+ global resolvers
reverse_dnsPTR record + FCrDNS verification
asn_lookupASN/BGP network identification + abuse contact
whois_lookupRDAP/WHOIS domain registration data
subdomain_discoveryPassive subdomain enumeration from CT logs, operational-name flags (dev/staging/admin), wildcard detection
lookalike_domainsTyposquat variants that are actually registered — homoglyph, affix (brand-login), TLD swap, keyboard slips — with the domain's own defensive registrations separated out
owasp_checkOWASP-mapped checks that can be observed passively (headers, TLS, exposed files), honest about what is out of scope
impersonation_exposureBrand impersonation exposure grade: third-party lookalikes + exposed operational subdomains + wildcard certs
golive_checkGo-live readiness — DNS, propagation, SSL, HTTP, registration in one READY / CAUTION / NOT READY verdict
domain_changesWhat changed since the last check — status, grade, issuer, DNS, issues. Time series from DechoNet monitoring
ip_infoPublic IP, ISP, ASN, proxy detection
email_header_analysisEmail delivery route tracing + auth results
subnet_calcCIDR subnet calculator (offline)

Every tool response ends with a link to the full interactive report on dechonet.com for the human behind the agent.

Example Prompts

Once connected, try asking Claude:

  • "Audit the security posture of example.com"
  • "Is the SSL certificate for mysite.com about to expire?"
  • "Which subdomains of example.com are exposed in CT logs?"
  • "Are there registered lookalike domains of mybrand.com?"
  • "How exposed is mybrand.com to impersonation?"
  • "Is example.com ready to go live?"
  • "What changed on example.com since the last check?"
  • "Analyze these email headers: [paste headers]"
  • "What's the ASN for 8.8.8.8?"

Local SSE Transport

For a self-hosted HTTP/SSE bridge (the hosted remote endpoint above is usually simpler):

npm run start:sse
# Server runs on http://localhost:3100
# SSE endpoint: http://localhost:3100/sse

Development

npm install
npm run build    # TypeScript → build/
npm run dev      # Run with tsx (stdio)
npm run start:sse # Run SSE server

How It Works

The MCP server calls DechoNet's public API (https://dechonet.com/api/util/*) — the same backend as the dechonet.com web tools — and returns structured results with:

  • Status (ok/warn/bad)
  • KPIs (key numbers per tool)
  • Issues with severity (critical/warning/info) and confidence levels
  • Actionable remediation steps
  • Raw data (full JSON)

All data comes from public sources (DNS, HTTP headers, SSL certificates, CT logs, RDAP). Passive by design: no active exploitation, and a registered lookalike is reported as a fact to verify, never as an accusation.

Environment Variables

VariableDefaultDescription
DECHONET_URLhttps://dechonet.comAPI base URL
DECHONET_LOCALEenResponse language (en or ko)
PORT3100SSE server port

About DechoNet

DechoNet is a domain security reconnaissance platform — distributed observation, cross-verification. The same diagnostics ship three ways: free web tools, error-fix guides, and this MCP server.

MIT licensed. Issues and PRs welcome.

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y dechonet-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "com-dechonet-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "dechonet-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

dechonet-mcpnpm

Compatible MCP Clients

com.dechonet/mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More