DNStwist

Local

API Integration

Integrate this MCP server into your applications.

Get your API Key

You'll need to login and generate a Smithery API key to connect to this server.

Installation

Install the Smithery and MCP SDKs using npm:

npm install @smithery/sdk @modelcontextprotocol/sdk

TypeScript SDK

Use Smithery's TypeScript SDK to connect to this MCP server:

typescript


import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js"

const transport = new StdioClientTransport({
  "command": "npx",
  "args": [
    "-y",
    "@burtthecoder/mcp-dnstwist"
  ],
  "env": {
    "DOMAIN": "example.com",
    "NAMESERVERS": "1.1.1.1,8.8.8.8",
    "THREADS": 50,
    "FORMAT": "json",
    "REGISTERED_ONLY": "true",
    "MXCHECK": "true",
    "BANNERS": "true",
    "PATH": process.env.PATH
  }
})

// Create MCP client
import { Client } from "@modelcontextprotocol/sdk/client/index.js"

const client = new Client({
	name: "Test client",
	version: "1.0.0"
})
await client.connect(transport)

// Use the server tools with your LLM application
const tools = await client.listTools()
console.log(`Available tools: ${tools.map(t => t.name).join(", ")}`)

// Example: Call a tool
// const result = await client.callTool("tool_name", { param1: "value1" })

Configuration Schema

Full JSON Schema for server configuration:

json

{
  "type": "object",
  "required": [
    "domain"
  ],
  "properties": {
    "domain": {
      "type": "string",
      "description": "The domain name to analyze."
    },
    "format": {
      "type": "string",
      "default": "json",
      "description": "Output format (json, csv, list)."
    },
    "banners": {
      "type": "boolean",
      "default": true,
      "description": "Capture HTTP banner information."
    },
    "mxcheck": {
      "type": "boolean",
      "default": true,
      "description": "Check for MX records."
    },
    "threads": {
      "type": "number",
      "default": 50,
      "description": "Number of threads for parallel processing."
    },
    "nameservers": {
      "type": "string",
      "default": "1.1.1.1",
      "description": "Comma-separated list of DNS servers."
    },
    "registeredOnly": {
      "type": "boolean",
      "default": true,
      "description": "Show only registered domains."
    }
  }
}