intodns-mcp 1.0.0

package/README.md

@@ -0,0 +1,77 @@
+# IntoDNS MCP Server
+
+An [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that gives AI assistants (Claude, Cursor, Windsurf, etc.) direct access to [IntoDNS.ai](https://intodns.ai) DNS and email security scanning.
+
+Ask your AI: *"Check the DNS security of example.com"* and it will run a live scan, grade the domain, and explain the findings — no copy-pasting, no tab switching.
+
+## Tools
+
+| Tool | What it does |
+|------|-------------|
+| `scan_domain` | Full DNS & email security scan — grade (A+ to F), score, 50+ checks |
+| `check_email_security` | SPF, DKIM, DMARC validation + blacklist status |
+| `lookup_dns` | DNS record lookup (A, AAAA, MX, TXT, NS, CNAME, SOA, CAA, SRV) |
+| `check_dns_propagation` | Global propagation check across multiple resolvers |
+| `validate_dnssec` | DNSSEC signing, key chain, and DS record validation |
+
+Free to use. No API key required. Powered by [IntoDNS.ai](https://intodns.ai).
+
+## Quick Start (Claude Desktop)
+
+### Option A — npx (no install)
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "intodns": {
+      "command": "npx",
+      "args": ["-y", "intodns-mcp"]
+    }
+  }
+}
+```
+
+### Option B — global install
+
+```bash
+npm install -g intodns-mcp
+```
+
+Then in `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "intodns": {
+      "command": "intodns-mcp"
+    }
+  }
+}
+```
+
+Restart Claude Desktop after editing the config.
+
+## Usage with Claude
+
+Once connected, you can ask Claude things like:
+
+- *"Scan example.com and tell me what's wrong with their email security"*
+- *"Does example.com have DMARC configured correctly?"*
+- *"Look up the MX records for example.com"*
+- *"Has my SPF change propagated globally yet?"*
+- *"Check if example.com is on any email blacklists"*
+
+## Other MCP clients
+
+Works with any MCP-compatible client (Cursor, Windsurf, Continue, etc.). Use the same `command` / `args` format from the config above.
+
+## Requirements
+
+- Node.js 18+
+- Internet access to reach `intodns.ai`
+
+## License
+
+MIT — built by [Cobytes B.V.](https://cobytes.com)

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const zod_1 = require("zod");
+const BASE_URL = "https://intodns.ai/api";
+async function apiFetch(path) {
+    const res = await fetch(`${BASE_URL}${path}`, {
+        headers: { "User-Agent": "intodns-mcp/1.0" },
+    });
+    if (!res.ok) {
+        throw new Error(`IntoDNS.ai API error: ${res.status} ${res.statusText}`);
+    }
+    return res.json();
+}
+const server = new mcp_js_1.McpServer({
+    name: "intodns",
+    version: "1.0.0",
+});
+server.tool("scan_domain", "Run a full DNS & email security scan on a domain. Returns a grade (A+ to F), security score, and findings for DNS, email authentication (SPF/DKIM/DMARC), blacklists, and DNSSEC.", { domain: zod_1.z.string().describe("Domain name to scan, e.g. example.com") }, async ({ domain }) => {
+    const data = await apiFetch(`/scan/quick?domain=${encodeURIComponent(domain)}`);
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+});
+server.tool("check_email_security", "Check email authentication records for a domain: SPF, DKIM, DMARC, and blacklist status. Returns parsed records, validity, issues, and recommendations.", { domain: zod_1.z.string().describe("Domain name to check, e.g. example.com") }, async ({ domain }) => {
+    const data = await apiFetch(`/email/check?domain=${encodeURIComponent(domain)}`);
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+});
+server.tool("lookup_dns", "Look up DNS records for a domain. Supports record types: A, AAAA, MX, TXT, NS, CNAME, SOA, CAA, SRV.", {
+    domain: zod_1.z.string().describe("Domain name to look up"),
+    type: zod_1.z
+        .enum(["A", "AAAA", "MX", "TXT", "NS", "CNAME", "SOA", "CAA", "SRV"])
+        .describe("DNS record type"),
+}, async ({ domain, type }) => {
+    const data = await apiFetch(`/dns/lookup?domain=${encodeURIComponent(domain)}&type=${type}`);
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+});
+server.tool("check_dns_propagation", "Check if DNS changes have propagated globally by querying multiple resolvers across different regions.", { domain: zod_1.z.string().describe("Domain name to check propagation for") }, async ({ domain }) => {
+    const data = await apiFetch(`/dns/propagation?domain=${encodeURIComponent(domain)}`);
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+});
+server.tool("validate_dnssec", "Validate DNSSEC configuration for a domain. Checks signing, key chain, and DS record presence.", { domain: zod_1.z.string().describe("Domain name to validate DNSSEC for") }, async ({ domain }) => {
+    const data = await apiFetch(`/dns/dnssec?domain=${encodeURIComponent(domain)}`);
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+});
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch(console.error);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "intodns-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for IntoDNS.ai — DNS & email security scanning from Claude and other AI assistants",
+  "main": "dist/index.js",
+  "bin": {
+    "intodns-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "dns",
+    "email-security",
+    "spf",
+    "dkim",
+    "dmarc",
+    "dnssec",
+    "claude",
+    "intodns"
+  ],
+  "author": "Cobytes B.V.",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.10.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RoscoNL/intodns-mcp-server.git"
+  },
+  "homepage": "https://intodns.ai"
+}