Skip to content
MCP server

DNSFilter MCP

DNSFilter for MSPs: why a site is blocked, preview-first allows, unblock requests, agent…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.6
Listing updated
4 days ago

About DNSFilter MCP

DNSFilter MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

DNSFilter for MSPs: why a site is blocked, preview-first allows, unblock requests, agent drift.

Install

Run in a terminal

claude mcp add dnsfilter-mcp --env DNSFILTER_API_KEY='<DNSFILTER_API_KEY>' --env DNSFILTER_MCP_HTTP_TOKEN='<DNSFILTER_MCP_HTTP_TOKEN>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/dnsfilter-v0.1.6/dnsfilter-mcp.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "dnsfilter-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/dnsfilter-v0.1.6/dnsfilter-mcp.mcpb"
      ],
      "env": {
        "DNSFILTER_API_KEY": "<DNSFILTER_API_KEY>",
        "DNSFILTER_MCP_HTTP_TOKEN": "<DNSFILTER_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "dnsfilter-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/dnsfilter-v0.1.6/dnsfilter-mcp.mcpb"
      ],
      "env": {
        "DNSFILTER_API_KEY": "<DNSFILTER_API_KEY>",
        "DNSFILTER_MCP_HTTP_TOKEN": "<DNSFILTER_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "dnsfilter-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/dnsfilter-v0.1.6/dnsfilter-mcp.mcpb"
      ],
      "env": {
        "DNSFILTER_API_KEY": "<DNSFILTER_API_KEY>",
        "DNSFILTER_MCP_HTTP_TOKEN": "<DNSFILTER_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "dnsfilter-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/dnsfilter-v0.1.6/dnsfilter-mcp.mcpb"
      ],
      "env": {
        "DNSFILTER_API_KEY": "<DNSFILTER_API_KEY>",
        "DNSFILTER_MCP_HTTP_TOKEN": "<DNSFILTER_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "dnsfilter-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/dnsfilter-v0.1.6/dnsfilter-mcp.mcpb"
      ],
      "env": {
        "DNSFILTER_API_KEY": "<DNSFILTER_API_KEY>",
        "DNSFILTER_MCP_HTTP_TOKEN": "<DNSFILTER_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Configuration

  • DNSFILTER_BASE_URLOptional: DNSFilter API base URL (default https://api.dnsfilter.com).
  • DNSFILTER_API_KEYDNSFilter API token (bare token, no Bearer prefix), from Account Settings, API Tokens.Required
  • DNSFILTER_USER_AGENTOptional: override the User-Agent the CLI sends.
  • DNSFILTER_MCP_READ_ONLYOptional: set to 1 so the MCP server offers DNSFilter reads only, without secret-bearing reads.
  • DNSFILTER_NO_LOCAL_DATAOptional. Set to 1 to keep no local copy of API responses: reads go to the API and the response cache is off.
  • DNSFILTER_MCP_HTTP_TOKENBearer token callers must present when the server runs with --transport http; not used by stdio.
  • PRINTING_PRESS_CLIENT_PROFILENot enforced by this connector (no tenant-gated profiles); leave unset. It does not limit access.

Pricing

Open source

DNSFilter MCP FAQ

Is DNSFilter MCP free?

Yes. DNSFilter MCP is open source, so you can use and self-host it for free.

How do I add DNSFilter MCP to Claude Code?

Run this command in your terminal: claude mcp add dnsfilter-mcp --env DNSFILTER_API_KEY='<DNSFILTER_API_KEY>' --env DNSFILTER_MCP_HTTP_TOKEN='<DNSFILTER_MCP_HTTP_TOKEN>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/dnsfilter-v0.1.6/dnsfilter-mcp.mcpb