# DNSFilter (oci · ghcr.io/wyre-ai/dnsfilter-mcp:v1.0.0)

MCP server for DNSFilter's DNS security/filtering API.

- Trust score: 36/100 (low)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-21

## Components

- oci · `ghcr.io/wyre-ai/dnsfilter-mcp:v1.0.0`: 36/100 (this document), [markdown](https://verifymcp.io/servers/wyre-ai-dnsfilter-mcp/ghcr-io-wyre-ai-dnsfilter-mcp-v1-0-0.md), [page](https://verifymcp.io/servers/wyre-ai-dnsfilter-mcp/ghcr-io-wyre-ai-dnsfilter-mcp-v1-0-0)

## Channel facts

- Registry: `oci`
- Package: `ghcr.io/wyre-ai/dnsfilter-mcp:v1.0.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-21.

- **Supply Chain Security**: 0/100
  - Malware scan not yet available for this package.
  - Known CVEs could not be checked: this artifact ships no SBOM, so there is no dependency list to read. Publishing one would let us assess it.
  - Install-script risk not yet assessed.
  - Dependency health could not be checked: this artifact ships no SBOM, so there is no dependency list to read. Publishing one would let us assess it.
- **Provenance & Transparency**: 32/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - License check failed: the license (NOASSERTION) isn't a recognized OSI-approved license.
  - Actively maintained (last published 0 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 62/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 16922 tokens (~296/item across 57 items; 57 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 57 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 57 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 2 categories.** Categories scored 0 because we could not verify them: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### How do I install the DNSFilter MCP server?

DNSFilter runs locally as a container image, launched with docker run --rm -i ghcr.io/wyre-ai/dnsfilter-mcp:v1.0.0. Ready-made configuration for Claude, Cursor, VS Code, Codex and 3 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add wyre-ai-dnsfilter-mcp -- docker run --rm -i ghcr.io/wyre-ai/dnsfilter-mcp:v1.0.0
```

### Cursor

```json
{
  "mcpServers": {
    "wyre-ai-dnsfilter-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/wyre-ai/dnsfilter-mcp:v1.0.0"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "wyre-ai-dnsfilter-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/wyre-ai/dnsfilter-mcp:v1.0.0"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add wyre-ai-dnsfilter-mcp -- docker run --rm -i ghcr.io/wyre-ai/dnsfilter-mcp:v1.0.0
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "wyre-ai-dnsfilter-mcp": {
      "type": "local",
      "command": [
        "docker",
        "run",
        "--rm",
        "-i",
        "ghcr.io/wyre-ai/dnsfilter-mcp:v1.0.0"
      ],
      "enabled": true
    }
  }
}
```

### Hermes

```yaml
mcp_servers:
  wyre-ai-dnsfilter-mcp:
    command: "docker"
    args: ["run", "--rm", "-i", "ghcr.io/wyre-ai/dnsfilter-mcp:v1.0.0"]
```

### Netclaw

```json
{
  "McpServers": {
    "wyre-ai-dnsfilter-mcp": {
      "Transport": "stdio",
      "Command": "docker",
      "Arguments": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/wyre-ai/dnsfilter-mcp:v1.0.0"
      ]
    }
  }
}
```

### Other

```json
{
  "mcpServers": {
    "wyre-ai-dnsfilter-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/wyre-ai/dnsfilter-mcp:v1.0.0"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-20 (score 36)

First indexed and scored.

## MCP tools (57)

### `dnsfilter_list_organizations` (~220 tokens)

List the organizations visible to this API key, with basic info (name, type, MSP relationships). Organization IDs from this response are required by dnsfilter_get_organization, dnsfilter_list_networks/policies/block_pages (via organization_id), and every traffic-report tool.

Input parameters:

- `basic_info` (boolean): Return only the most basic organization info. Defaults to false.
- `exclude_inherit_privacy_mode` (boolean): Exclude organizations that have inherit privacy mode.
- `managed_by_msp_id` (number): Filter to sub-organizations managed by this MSP's ID.
- `name` (string): Filter by organization name.
- `owned_msp_id` (number): Filter to parent organizations owned by this MSP's ID.
- `page` (object): Pagination, e.g. { "number": 1, "size": 10 }. 'size' defaults to 10 (max 100).
- `pii_grid_search` (string): Filter by organization name or privacy mode.
- `type` (string): Filter by organization type.

### `dnsfilter_get_organization` (~64 tokens)

Get one organization's basic information. Requires an organization ID from dnsfilter_list_organizations.

Input parameters:

- `id` (number, required): Organization ID, from dnsfilter_list_organizations.
- `include_current_mrr` (boolean): Include current MRR (monthly recurring revenue) information.

### `dnsfilter_get_organization_settings` (~80 tokens)

Get organization-level settings, optionally scoped to a specific organization or MSP.

Input parameters:

- `msp_id` (number): MSP ID to scope to.
- `name` (string): Filter by organization name.
- `organization_id` (number): Organization ID to scope to.
- `organization_ids` (string): Comma-separated organization IDs to scope to.

### `dnsfilter_list_networks` (~203 tokens)

List the networks (sites/locations) visible to this API key, with basic info and whether a filtering policy is assigned. Network IDs from this response are required by dnsfilter_get_network and can scope most traffic-report tools via network_ids.

Input parameters:

- `basic_info` (boolean): Return only the most basic network info. Defaults to false.
- `count_network_ips` (boolean): Include a count of associated IP addresses. Defaults to false.
- `force_truncate_ips` (boolean): Omit IP address details from the response. Defaults to false.
- `page` (object): Pagination, e.g. { "number": 1, "size": 10 }. 'size' defaults to 10 (max 100).
- `protected` (boolean): Filter to networks with an assigned policy.
- `search` (string): Search by network name, hostname, IP address, etc.
- `unprotected` (boolean): Filter to networks without an assigned policy.

### `dnsfilter_get_network` (~64 tokens)

Get one network's basic information. Requires a network ID from dnsfilter_list_networks.

Input parameters:

- `count_network_ips` (boolean): Include a count of associated IP addresses. Defaults to false.
- `id` (number, required): Network ID, from dnsfilter_list_networks.

### `dnsfilter_lookup_network_by_ip` (~46 tokens)

Find the network associated with a given source IP address, along with that network's block-page branding.

Input parameters:

- `requesting_ip_address` (string, required): IP address to look up.

### `dnsfilter_get_networks_geo` (~45 tokens)

Get every visible network's geo/location metadata only (name, lat/long, physical address) - a lighter-weight variant of dnsfilter_list_networks for mapping.

### `dnsfilter_list_policies` (~112 tokens)

List filtering policies visible to this API key. Policy IDs from this response are required by dnsfilter_get_policy and dnsfilter_get_policy_permissive_mode.

Input parameters:

- `include_global_policies` (boolean): Include global (template) policies in the listing.
- `organization_id` (number): Filter to policies belonging to this organization.
- `page` (object): Pagination, e.g. { "number": 1, "size": 10 }. 'size' defaults to 10 (max 100).

### `dnsfilter_get_policy` (~90 tokens)

Get one policy's full configuration: allow/block domain lists, allow/block category rules, allowed/blocked applications, and which networks it's assigned to. Requires a policy ID from dnsfilter_list_policies.

Input parameters:

- `id` (number, required): Policy ID, from dnsfilter_list_policies.
- `include_relationships` (boolean): Include related resources (organization, networks) in the response. Defaults to true.

### `dnsfilter_get_application_policies` (~93 tokens)

Get which policies in an organization allow or block a specific application. Requires an application ID and organization ID.

Input parameters:

- `application_id` (number, required): Application ID to look up.
- `name` (string): Filter to policies whose name matches (or partially matches).
- `organization_id` (number, required): Organization ID to scope the search to.
- `policy_ids` (array): Limit the search to these policy IDs.

### `dnsfilter_get_policy_permissive_mode` (~60 tokens)

Get whether a policy currently has permissive (monitor-only, non-blocking) mode enabled. Requires a policy ID from dnsfilter_list_policies.

Input parameters:

- `id` (number, required): Policy ID, from dnsfilter_list_policies.

### `dnsfilter_list_categories` (~97 tokens)

List DNSFilter's content-filtering categories (e.g. Malware, Gambling, Social Networking) used to build allow/block rules in a policy. Category IDs from this response are required by dnsfilter_get_category and can filter traffic-report tools via category_ids.

Input parameters:

- `page` (object): Pagination, e.g. { "number": 1, "size": 10 }. 'size' defaults to 10 (max 100).

### `dnsfilter_get_category` (~49 tokens)

Get one content category's details and hierarchy (parent/child categories). Requires a category ID from dnsfilter_list_categories.

Input parameters:

- `id` (number, required): Category ID, from dnsfilter_list_categories.

### `dnsfilter_list_application_categories` (~90 tokens)

List application categories, used for the application allow/block surface of a policy (distinct from content categories). IDs from this response are required by dnsfilter_get_application_category and can filter traffic-report tools via application_category_ids.

Input parameters:

- `page` (object): Pagination, e.g. { "number": 1, "size": 10 }. 'size' defaults to 10 (max 100).

### `dnsfilter_get_application_category` (~47 tokens)

Get one application category's details. Requires an application category ID from dnsfilter_list_application_categories.

Input parameters:

- `id` (number, required): Application category ID, from dnsfilter_list_application_categories.

### `dnsfilter_list_block_pages` (~101 tokens)

List the custom block pages configured for the current user/organization (shown to end users when a request is filtered). Block page IDs from this response are required by dnsfilter_get_block_page.

Input parameters:

- `organization_id` (number): Filter to block pages belonging to this organization.
- `page` (object): Pagination, e.g. { "number": 1, "size": 10 }. 'size' defaults to 10 (max 100).

### `dnsfilter_get_block_page` (~81 tokens)

Get one custom block page's configuration: branding (org name, logo), contact email, and appearance settings. Requires a block page ID from dnsfilter_list_block_pages.

Input parameters:

- `id` (number, required): Block page ID, from dnsfilter_list_block_pages.
- `include_relationships` (boolean): Include related resources in the response. Defaults to true.

### `dnsfilter_get_organization_usage` (~132 tokens)

Get usage information (plan, term, user/wifi counts, total requests, estimated users) for an organization over a date range. Maximum range is 365 days. Requires an organization ID from dnsfilter_list_organizations.

Input parameters:

- `from` (string, required): Range start date, ISO 8601 (e.g. "2026-08-01").
- `id` (number, required): Organization ID, from dnsfilter_list_organizations.
- `to` (string, required): Range end date, ISO 8601 (e.g. "2026-09-01"). Maximum range is 365 days.

### `dnsfilter_get_organization_usage_detailed` (~125 tokens)

Get the detailed (per-metric) breakdown of an organization's usage over a date range. Maximum range is 365 days. Requires an organization ID from dnsfilter_list_organizations.

Input parameters:

- `from` (string, required): Range start date, ISO 8601 (e.g. "2026-08-01").
- `id` (number, required): Organization ID, from dnsfilter_list_organizations.
- `to` (string, required): Range end date, ISO 8601 (e.g. "2026-09-01"). Maximum range is 365 days.

### `dnsfilter_get_qps` (~488 tokens)

Queries-per-second time series - the closest thing to a live traffic pulse.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `bucket_size` (string): Time-bucket size: 'auto' (default), '15min', or '1day'. Auto picks 15min for a <24h range and 1day for a >=24h range.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `mac_addresses` (string): Comma-separated MAC addresses to filter to.
- `msp_id` (number): MSP ID to scope the report to.
- `nat_ips` (string): Comma-separated NAT IP addresses to filter to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `private_ip` (string): Filter to a specific private/internal IP address.
- `private_ip_from` (string): Lower bound of a private/internal IP address range.
- `private_ip_to` (string): Upper bound of a private/internal IP address range.
- `security_report` (string): Threat-only report. 'all' returns both threats and non-threats.
- `show_individual_networks` (boolean): Group results by individual network ID. Defaults to false.
- `source` (string): Comma-separated traffic source. Defaults to all.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_qps_active_agents` (~400 tokens)

Queries-per-second broken out by active client/agent.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `mac_addresses` (string): Comma-separated MAC addresses to filter to.
- `nat_ips` (string): Comma-separated NAT IP addresses to filter to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `private_ip` (string): Filter to a specific private/internal IP address.
- `private_ip_from` (string): Lower bound of a private/internal IP address range.
- `private_ip_to` (string): Upper bound of a private/internal IP address range.
- `security_report` (string): Threat-only report. 'all' returns both threats and non-threats.
- `source` (string): Comma-separated traffic source. Defaults to all.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_qps_active_organizations` (~415 tokens)

Queries-per-second broken out by active organization.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `mac_addresses` (string): Comma-separated MAC addresses to filter to.
- `msp_id` (number): MSP ID to scope the report to.
- `nat_ips` (string): Comma-separated NAT IP addresses to filter to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `private_ip` (string): Filter to a specific private/internal IP address.
- `private_ip_from` (string): Lower bound of a private/internal IP address range.
- `private_ip_to` (string): Upper bound of a private/internal IP address range.
- `security_report` (string): Threat-only report. 'all' returns both threats and non-threats.
- `source` (string): Comma-separated traffic source. Defaults to all.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_query_logs` (~623 tokens)

Raw DNS query log entries - domain queried, requester, category, and allow/block result. The most granular, PII-bearing report this connector exposes.

Input parameters:

- `agent_id` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `application_category_ids` (string): Comma-separated application category IDs to filter to.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `category_ids` (string): Comma-separated content-category IDs to filter to.
- `collection_id` (string): Comma-separated collection (roaming-client group) IDs.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `domain` (string): Filter to a specific domain.
- `exclude_category_ids` (string): Comma-separated content-category IDs to exclude.
- `fqdn` (string): Filter to a specific fully-qualified domain name.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `mac_addresses` (string): Comma-separated MAC addresses to filter to.
- `nat_ips` (string): Comma-separated NAT IP addresses to filter to.
- `network_id` (string): Comma-separated network (site) IDs. Defaults to all.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_id` (number): Organization ID.
- `page` (object): Pagination, e.g. { "number": 1, "size": 10 }. 'size' defaults to 10 (max 100).
- `policy_ids` (string): Comma-separated policy IDs to filter to.
- `private_ip` (string): Filter to a specific private/internal IP address.
- `private_ip_from` (string): Lower bound of a private/internal IP address range.
- `private_ip_to` (string): Upper bound of a private/internal IP address range.
- `question_type` (string): Filter to a specific DNS question (record) type, e.g. A, AAAA, CNAME.
- `result` (string): Filter to a specific query result.
- `security_report` (string): Threat-only report. 'all' returns both threats and non-threats.
- `source` (string): Comma-separated traffic source. Defaults to all.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `user_id` (string): Comma-separated local user IDs. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_top_agents` (~458 tokens)

Clients/agents generating the most traffic.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `mac_addresses` (string): Comma-separated MAC addresses to filter to.
- `msp_id` (number): MSP ID to scope the report to.
- `name` (string): Filter/search by name.
- `nat_ips` (string): Comma-separated NAT IP addresses to filter to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `page` (object): Pagination, e.g. { "number": 1, "size": 10 }. 'size' defaults to 10 (max 100).
- `private_ip` (string): Filter to a specific private/internal IP address.
- `private_ip_from` (string): Lower bound of a private/internal IP address range.
- `private_ip_to` (string): Upper bound of a private/internal IP address range.
- `security_report` (string): Threat-only report. 'all' returns both threats and non-threats.
- `source` (string): Comma-separated traffic source. Defaults to all.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_top_application_categories` (~441 tokens)

Application categories generating the most traffic.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `mac_addresses` (string): Comma-separated MAC addresses to filter to.
- `msp_id` (number): MSP ID to scope the report to.
- `name` (string): Filter/search by name.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `page` (object): Pagination, e.g. { "number": 1, "size": 10 }. 'size' defaults to 10 (max 100).
- `private_ip` (string): Filter to a specific private/internal IP address.
- `private_ip_from` (string): Lower bound of a private/internal IP address range.
- `private_ip_to` (string): Upper bound of a private/internal IP address range.
- `security_report` (string): Threat-only report. 'all' returns both threats and non-threats.
- `source` (string): Comma-separated traffic source. Defaults to all.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_top_categories` (~440 tokens)

Content categories generating the most traffic.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `mac_addresses` (string): Comma-separated MAC addresses to filter to.
- `msp_id` (number): MSP ID to scope the report to.
- `name` (string): Filter/search by name.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `page` (object): Pagination, e.g. { "number": 1, "size": 10 }. 'size' defaults to 10 (max 100).
- `private_ip` (string): Filter to a specific private/internal IP address.
- `private_ip_from` (string): Lower bound of a private/internal IP address range.
- `private_ip_to` (string): Upper bound of a private/internal IP address range.
- `security_report` (string): Threat-only report. 'all' returns both threats and non-threats.
- `source` (string): Comma-separated traffic source. Defaults to all.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_top_collections` (~464 tokens)

Collections (roaming-client groupings) generating the most traffic.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `mac_addresses` (string): Comma-separated MAC addresses to filter to.
- `msp_id` (number): MSP ID to scope the report to.
- `name` (string): Filter/search by name.
- `nat_ips` (string): Comma-separated NAT IP addresses to filter to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `page` (object): Pagination, e.g. { "number": 1, "size": 10 }. 'size' defaults to 10 (max 100).
- `private_ip` (string): Filter to a specific private/internal IP address.
- `private_ip_from` (string): Lower bound of a private/internal IP address range.
- `private_ip_to` (string): Upper bound of a private/internal IP address range.
- `security_report` (string): Threat-only report. 'all' returns both threats and non-threats.
- `source` (string): Comma-separated traffic source. Defaults to all.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_top_domains` (~472 tokens)

Domains queried most often.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `category_ids` (string): Comma-separated content-category IDs to filter to.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `domain` (string): Filter to a specific domain.
- `fqdn` (string): Filter to a specific fully-qualified domain name.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `mac_addresses` (string): Comma-separated MAC addresses to filter to.
- `msp_id` (number): MSP ID to scope the report to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `page` (object): Pagination, e.g. { "number": 1, "size": 10 }. 'size' defaults to 10 (max 100).
- `private_ip` (string): Filter to a specific private/internal IP address.
- `private_ip_from` (string): Lower bound of a private/internal IP address range.
- `private_ip_to` (string): Upper bound of a private/internal IP address range.
- `security_report` (string): Threat-only report. 'all' returns both threats and non-threats.
- `source` (string): Comma-separated traffic source. Defaults to all.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_top_networks` (~441 tokens)

Networks generating the most traffic.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `mac_addresses` (string): Comma-separated MAC addresses to filter to.
- `name` (string): Filter/search by name.
- `nat_ips` (string): Comma-separated NAT IP addresses to filter to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `page` (object): Pagination, e.g. { "number": 1, "size": 10 }. 'size' defaults to 10 (max 100).
- `private_ip` (string): Filter to a specific private/internal IP address.
- `private_ip_from` (string): Lower bound of a private/internal IP address range.
- `private_ip_to` (string): Upper bound of a private/internal IP address range.
- `security_report` (string): Threat-only report. 'all' returns both threats and non-threats.
- `source` (string): Comma-separated traffic source. Defaults to all.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_top_organizations_requests` (~232 tokens)

Organizations generating the most request volume.

Input parameters:

- `bucket_size` (string): Time-bucket size: 'auto' (default), '15min', or '1day'. Auto picks 15min for a <24h range and 1day for a >=24h range.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `msp_id` (number): MSP ID to scope the report to.
- `organization_id` (number): Organization ID.
- `page` (object): Pagination, e.g. { "number": 1, "size": 10 }. 'size' defaults to 10 (max 100).
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.

### `dnsfilter_get_top_users` (~457 tokens)

Local users generating the most traffic.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `mac_addresses` (string): Comma-separated MAC addresses to filter to.
- `msp_id` (number): MSP ID to scope the report to.
- `name` (string): Filter/search by name.
- `nat_ips` (string): Comma-separated NAT IP addresses to filter to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `page` (object): Pagination, e.g. { "number": 1, "size": 10 }. 'size' defaults to 10 (max 100).
- `private_ip` (string): Filter to a specific private/internal IP address.
- `private_ip_from` (string): Lower bound of a private/internal IP address range.
- `private_ip_to` (string): Upper bound of a private/internal IP address range.
- `security_report` (string): Threat-only report. 'all' returns both threats and non-threats.
- `source` (string): Comma-separated traffic source. Defaults to all.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_total_applications_agents_stats` (~429 tokens)

Application request counts broken out by client/agent.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_category_ids` (string): Comma-separated application category IDs to filter to.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `mac_addresses` (string): Comma-separated MAC addresses to filter to.
- `name` (string): Filter/search by name.
- `nat_ips` (string): Comma-separated NAT IP addresses to filter to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `private_ip` (string): Filter to a specific private/internal IP address.
- `private_ip_from` (string): Lower bound of a private/internal IP address range.
- `private_ip_to` (string): Upper bound of a private/internal IP address range.
- `security_report` (string): Threat-only report. 'all' returns both threats and non-threats.
- `source` (string): Comma-separated traffic source. Defaults to all.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_total_applications_collections_stats` (~428 tokens)

Application request counts broken out by collection.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_category_ids` (string): Comma-separated application category IDs to filter to.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `mac_addresses` (string): Comma-separated MAC addresses to filter to.
- `name` (string): Filter/search by name.
- `nat_ips` (string): Comma-separated NAT IP addresses to filter to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `private_ip` (string): Filter to a specific private/internal IP address.
- `private_ip_from` (string): Lower bound of a private/internal IP address range.
- `private_ip_to` (string): Upper bound of a private/internal IP address range.
- `security_report` (string): Threat-only report. 'all' returns both threats and non-threats.
- `source` (string): Comma-separated traffic source. Defaults to all.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_total_applications_networks_stats` (~428 tokens)

Application request counts broken out by network.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_category_ids` (string): Comma-separated application category IDs to filter to.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `mac_addresses` (string): Comma-separated MAC addresses to filter to.
- `name` (string): Filter/search by name.
- `nat_ips` (string): Comma-separated NAT IP addresses to filter to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `private_ip` (string): Filter to a specific private/internal IP address.
- `private_ip_from` (string): Lower bound of a private/internal IP address range.
- `private_ip_to` (string): Upper bound of a private/internal IP address range.
- `security_report` (string): Threat-only report. 'all' returns both threats and non-threats.
- `source` (string): Comma-separated traffic source. Defaults to all.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_total_applications_stats` (~439 tokens)

Total application request counts.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_category_ids` (string): Comma-separated application category IDs to filter to.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `mac_addresses` (string): Comma-separated MAC addresses to filter to.
- `msp_id` (number): MSP ID to scope the report to.
- `name` (string): Filter/search by name.
- `nat_ips` (string): Comma-separated NAT IP addresses to filter to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `private_ip` (string): Filter to a specific private/internal IP address.
- `private_ip_from` (string): Lower bound of a private/internal IP address range.
- `private_ip_to` (string): Upper bound of a private/internal IP address range.
- `security_report` (string): Threat-only report. 'all' returns both threats and non-threats.
- `source` (string): Comma-separated traffic source. Defaults to all.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_total_applications_users_stats` (~428 tokens)

Application request counts broken out by local user.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_category_ids` (string): Comma-separated application category IDs to filter to.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `mac_addresses` (string): Comma-separated MAC addresses to filter to.
- `name` (string): Filter/search by name.
- `nat_ips` (string): Comma-separated NAT IP addresses to filter to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `private_ip` (string): Filter to a specific private/internal IP address.
- `private_ip_from` (string): Lower bound of a private/internal IP address range.
- `private_ip_to` (string): Upper bound of a private/internal IP address range.
- `security_report` (string): Threat-only report. 'all' returns both threats and non-threats.
- `source` (string): Comma-separated traffic source. Defaults to all.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_total_categories` (~464 tokens)

Total content-category request counts over time.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `bucket_size` (string): Time-bucket size: 'auto' (default), '15min', or '1day'. Auto picks 15min for a <24h range and 1day for a >=24h range.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `mac_addresses` (string): Comma-separated MAC addresses to filter to.
- `msp_id` (number): MSP ID to scope the report to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `private_ip` (string): Filter to a specific private/internal IP address.
- `private_ip_from` (string): Lower bound of a private/internal IP address range.
- `private_ip_to` (string): Upper bound of a private/internal IP address range.
- `security_report` (string): Threat-only report. 'all' returns both threats and non-threats.
- `show_individual_networks` (boolean): Group results by individual network ID. Defaults to false.
- `source` (string): Comma-separated traffic source. Defaults to all.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_total_categories_organizations` (~452 tokens)

Total content-category request counts broken out by organization.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `bucket_size` (string): Time-bucket size: 'auto' (default), '15min', or '1day'. Auto picks 15min for a <24h range and 1day for a >=24h range.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `mac_addresses` (string): Comma-separated MAC addresses to filter to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `private_ip` (string): Filter to a specific private/internal IP address.
- `private_ip_from` (string): Lower bound of a private/internal IP address range.
- `private_ip_to` (string): Upper bound of a private/internal IP address range.
- `security_report` (string): Threat-only report. 'all' returns both threats and non-threats.
- `show_individual_organizations` (boolean): Group results by individual organization ID. Defaults to false.
- `source` (string): Comma-separated traffic source. Defaults to all.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_total_category_stats` (~182 tokens)

Content-category request-count summary.

Input parameters:

- `category_ids` (string): Comma-separated content-category IDs to filter to.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `msp_id` (number): MSP ID to scope the report to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_id` (number): Organization ID.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.

### `dnsfilter_get_total_client_stats` (~165 tokens)

Client/agent count summary.

Input parameters:

- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `msp_id` (number): MSP ID to scope the report to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_id` (number): Organization ID.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.

### `dnsfilter_get_total_deployments` (~65 tokens)

Deployed client/network counts.

Input parameters:

- `msp_id` (number): MSP ID to scope the report to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_id` (number): Organization ID.

### `dnsfilter_get_total_domain_stats` (~202 tokens)

Single-domain request-count summary - use with the domain/fqdn filter.

Input parameters:

- `domain` (string): Filter to a specific domain.
- `fqdn` (string): Filter to a specific fully-qualified domain name.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `msp_id` (number): MSP ID to scope the report to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_id` (number): Organization ID.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.

### `dnsfilter_get_total_domains` (~476 tokens)

Total domain request counts over time.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `bucket_size` (string): Time-bucket size: 'auto' (default), '15min', or '1day'. Auto picks 15min for a <24h range and 1day for a >=24h range.
- `category_ids` (string): Comma-separated content-category IDs to filter to.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `domain` (string): Filter to a specific domain.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `mac_addresses` (string): Comma-separated MAC addresses to filter to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `private_ip` (string): Filter to a specific private/internal IP address.
- `private_ip_from` (string): Lower bound of a private/internal IP address range.
- `private_ip_to` (string): Upper bound of a private/internal IP address range.
- `security_report` (string): Threat-only report. 'all' returns both threats and non-threats.
- `show_individual_networks` (boolean): Group results by individual network ID. Defaults to false.
- `source` (string): Comma-separated traffic source. Defaults to all.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_total_domains_organizations` (~480 tokens)

Total domain request counts broken out by organization.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `bucket_size` (string): Time-bucket size: 'auto' (default), '15min', or '1day'. Auto picks 15min for a <24h range and 1day for a >=24h range.
- `category_ids` (string): Comma-separated content-category IDs to filter to.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `domain` (string): Filter to a specific domain.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `mac_addresses` (string): Comma-separated MAC addresses to filter to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `private_ip` (string): Filter to a specific private/internal IP address.
- `private_ip_from` (string): Lower bound of a private/internal IP address range.
- `private_ip_to` (string): Upper bound of a private/internal IP address range.
- `security_report` (string): Threat-only report. 'all' returns both threats and non-threats.
- `show_individual_organizations` (boolean): Group results by individual organization ID. Defaults to false.
- `source` (string): Comma-separated traffic source. Defaults to all.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_total_domains_users` (~480 tokens)

Total domain request counts broken out by local user.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `bucket_size` (string): Time-bucket size: 'auto' (default), '15min', or '1day'. Auto picks 15min for a <24h range and 1day for a >=24h range.
- `category_ids` (string): Comma-separated content-category IDs to filter to.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `domain` (string): Filter to a specific domain.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `mac_addresses` (string): Comma-separated MAC addresses to filter to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `private_ip` (string): Filter to a specific private/internal IP address.
- `private_ip_from` (string): Lower bound of a private/internal IP address range.
- `private_ip_to` (string): Upper bound of a private/internal IP address range.
- `security_report` (string): Threat-only report. 'all' returns both threats and non-threats.
- `show_individual_users` (boolean): Group results by individual local user ID. Defaults to false.
- `source` (string): Comma-separated traffic source. Defaults to all.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_total_organizations_requests` (~427 tokens)

Total request counts broken out by organization.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `bucket_size` (string): Time-bucket size: 'auto' (default), '15min', or '1day'. Auto picks 15min for a <24h range and 1day for a >=24h range.
- `category_ids` (string): Comma-separated content-category IDs to filter to.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `domain` (string): Filter to a specific domain.
- `fqdn` (string): Filter to a specific fully-qualified domain name.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `msp_id` (number): MSP ID to scope the report to.
- `name` (string): Filter/search by name.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_id` (number): Organization ID.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `security_report` (string): Threat-only report. 'all' returns both threats and non-threats.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_total_organizations_stats` (~332 tokens)

Organization-level request-count summary.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_category_ids` (string): Comma-separated application category IDs to filter to.
- `bucket_size` (string): Time-bucket size: 'auto' (default), '15min', or '1day'. Auto picks 15min for a <24h range and 1day for a >=24h range.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `msp_id` (number): MSP ID to scope the report to.
- `name` (string): Filter/search by name.
- `organization_id` (number): Organization ID.
- `security_report` (string): Threat-only report. 'all' returns both threats and non-threats.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_total_requests` (~480 tokens)

Total DNS request counts over time.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `bucket_size` (string): Time-bucket size: 'auto' (default), '15min', or '1day'. Auto picks 15min for a <24h range and 1day for a >=24h range.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `mac_addresses` (string): Comma-separated MAC addresses to filter to.
- `msp_id` (number): MSP ID to scope the report to.
- `nat_ips` (string): Comma-separated NAT IP addresses to filter to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `private_ip` (string): Filter to a specific private/internal IP address.
- `private_ip_from` (string): Lower bound of a private/internal IP address range.
- `private_ip_to` (string): Upper bound of a private/internal IP address range.
- `security_report` (string): Threat-only report. 'all' returns both threats and non-threats.
- `show_individual_networks` (boolean): Group results by individual network ID. Defaults to false.
- `source` (string): Comma-separated traffic source. Defaults to all.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_total_requests_agents` (~485 tokens)

Total request counts broken out by client/agent.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `bucket_size` (string): Time-bucket size: 'auto' (default), '15min', or '1day'. Auto picks 15min for a <24h range and 1day for a >=24h range.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `mac_addresses` (string): Comma-separated MAC addresses to filter to.
- `msp_id` (number): MSP ID to scope the report to.
- `nat_ips` (string): Comma-separated NAT IP addresses to filter to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `private_ip` (string): Filter to a specific private/internal IP address.
- `private_ip_from` (string): Lower bound of a private/internal IP address range.
- `private_ip_to` (string): Upper bound of a private/internal IP address range.
- `security_report` (string): Threat-only report. 'all' returns both threats and non-threats.
- `show_individual_agents` (boolean): Group results by individual client/agent ID. Defaults to false.
- `source` (string): Comma-separated traffic source. Defaults to all.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_total_requests_collections` (~467 tokens)

Total request counts broken out by collection.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `bucket_size` (string): Time-bucket size: 'auto' (default), '15min', or '1day'. Auto picks 15min for a <24h range and 1day for a >=24h range.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `mac_addresses` (string): Comma-separated MAC addresses to filter to.
- `nat_ips` (string): Comma-separated NAT IP addresses to filter to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `private_ip` (string): Filter to a specific private/internal IP address.
- `private_ip_from` (string): Lower bound of a private/internal IP address range.
- `private_ip_to` (string): Upper bound of a private/internal IP address range.
- `security_report` (string): Threat-only report. 'all' returns both threats and non-threats.
- `show_individual_collections` (boolean): Group results by individual collection ID. Defaults to false.
- `source` (string): Comma-separated traffic source. Defaults to all.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_total_requests_geo` (~180 tokens)

Total request counts broken out by geography.

Input parameters:

- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `limit` (number, required): Limit the number of results returned.
- `msp_id` (number): MSP ID to scope the report to.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.

### `dnsfilter_get_total_requests_organizations` (~483 tokens)

Total request counts broken out by organization.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `bucket_size` (string): Time-bucket size: 'auto' (default), '15min', or '1day'. Auto picks 15min for a <24h range and 1day for a >=24h range.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `mac_addresses` (string): Comma-separated MAC addresses to filter to.
- `msp_id` (number): MSP ID to scope the report to.
- `nat_ips` (string): Comma-separated NAT IP addresses to filter to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `private_ip` (string): Filter to a specific private/internal IP address.
- `private_ip_from` (string): Lower bound of a private/internal IP address range.
- `private_ip_to` (string): Upper bound of a private/internal IP address range.
- `security_report` (string): Threat-only report. 'all' returns both threats and non-threats.
- `show_individual_organizations` (boolean): Group results by individual organization ID. Defaults to false.
- `source` (string): Comma-separated traffic source. Defaults to all.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_total_requests_users` (~483 tokens)

Total request counts broken out by local user.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `bucket_size` (string): Time-bucket size: 'auto' (default), '15min', or '1day'. Auto picks 15min for a <24h range and 1day for a >=24h range.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `mac_addresses` (string): Comma-separated MAC addresses to filter to.
- `msp_id` (number): MSP ID to scope the report to.
- `nat_ips` (string): Comma-separated NAT IP addresses to filter to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `private_ip` (string): Filter to a specific private/internal IP address.
- `private_ip_from` (string): Lower bound of a private/internal IP address range.
- `private_ip_to` (string): Upper bound of a private/internal IP address range.
- `security_report` (string): Threat-only report. 'all' returns both threats and non-threats.
- `show_individual_users` (boolean): Group results by individual local user ID. Defaults to false.
- `source` (string): Comma-separated traffic source. Defaults to all.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_total_roaming_clients` (~48 tokens)

Count of roaming (off-network) clients.

Input parameters:

- `msp_id` (number): MSP ID to scope the report to.
- `organization_id` (number): Organization ID.

### `dnsfilter_get_total_threats` (~427 tokens)

Total blocked-threat counts over time.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `bucket_size` (string): Time-bucket size: 'auto' (default), '15min', or '1day'. Auto picks 15min for a <24h range and 1day for a >=24h range.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `mac_addresses` (string): Comma-separated MAC addresses to filter to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `private_ip` (string): Filter to a specific private/internal IP address.
- `private_ip_from` (string): Lower bound of a private/internal IP address range.
- `private_ip_to` (string): Upper bound of a private/internal IP address range.
- `show_individual_networks` (boolean): Group results by individual network ID. Defaults to false.
- `source` (string): Comma-separated traffic source. Defaults to all.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_total_threats_organizations` (~431 tokens)

Total blocked-threat counts broken out by organization.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `bucket_size` (string): Time-bucket size: 'auto' (default), '15min', or '1day'. Auto picks 15min for a <24h range and 1day for a >=24h range.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `mac_addresses` (string): Comma-separated MAC addresses to filter to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `private_ip` (string): Filter to a specific private/internal IP address.
- `private_ip_from` (string): Lower bound of a private/internal IP address range.
- `private_ip_to` (string): Upper bound of a private/internal IP address range.
- `show_individual_organizations` (boolean): Group results by individual organization ID. Defaults to false.
- `source` (string): Comma-separated traffic source. Defaults to all.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

### `dnsfilter_get_total_threats_users` (~431 tokens)

Total blocked-threat counts broken out by local user.

Input parameters:

- `agent_ids` (string): Comma-separated user-agent (client) UUIDs. Defaults to all.
- `agent_types` (string): Comma-separated agent/client types.
- `application_ids` (string): Comma-separated application IDs to filter to.
- `bucket_size` (string): Time-bucket size: 'auto' (default), '15min', or '1day'. Auto picks 15min for a <24h range and 1day for a >=24h range.
- `collection_ids` (string): Comma-separated collection (roaming-client group) IDs.
- `from` (string): Report UTC lower bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (start of day). Defaults to 1 day ago.
- `mac_addresses` (string): Comma-separated MAC addresses to filter to.
- `network_ids` (string): Comma-separated network (site) IDs. Defaults to all.
- `organization_ids` (string): Comma-separated organization IDs. Defaults to the user organization ID. An inaccessible/unknown ID returns a 403.
- `private_ip` (string): Filter to a specific private/internal IP address.
- `private_ip_from` (string): Lower bound of a private/internal IP address range.
- `private_ip_to` (string): Upper bound of a private/internal IP address range.
- `show_individual_users` (boolean): Group results by individual local user ID. Defaults to false.
- `source` (string): Comma-separated traffic source. Defaults to all.
- `to` (string): Report UTC upper bound. Accepts YYYY-MM-DDThh:mm:ss[Z], YYYY-MM-DDThh:mm[Z], or a bare YYYY-MM-DD date (end of day, inclusive). Defaults to now.
- `type` (string): Report type. Defaults to all.
- `user_ids` (string): Comma-separated local user IDs. Defaults to all.

## Diagnostics

Captured diagnostic sections: Provenance. The full working is on the page: https://verifymcp.io/servers/wyre-ai-dnsfilter-mcp/ghcr-io-wyre-ai-dnsfilter-mcp-v1-0-0#diagnostics

## Score history

- 2026-09-21: 36
- 2026-09-20: 36

## Common questions

### What is the DNSFilter MCP server?

DNSFilter is an MCP server listed in the public MCP registry as io.github.WYRE-AI/dnsfilter-mcp. MCP server for DNSFilter's DNS security/filtering API. This page covers its container image (ghcr.io/wyre-ai/dnsfilter-mcp:v1.0.0).

### Is the DNSFilter MCP server safe to use?

DNSFilter scores 36 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the DNSFilter MCP server expose?

DNSFilter exposes 57 tools: dnsfilter_list_organizations, dnsfilter_get_organization, dnsfilter_get_organization_settings, dnsfilter_list_networks, dnsfilter_get_network, and 52 more. Their descriptions and schemas cost roughly 16,922 tokens of context every time the server is loaded.

### Is the DNSFilter MCP server still maintained?

DNSFilter is still listed as active in the MCP registry. We last reached this channel on 21 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the DNSFilter MCP server under?

DNSFilter declares the NOASSERTION licence, which is not on the OSI-approved list. Read the terms before using it at work, and note this covers the source only, not the cost of any service it calls.

## Links

- Repository: https://github.com/WYRE-AI/dnsfilter-mcp
- Changelog RSS feed: https://verifymcp.io/servers/wyre-ai-dnsfilter-mcp/ghcr-io-wyre-ai-dnsfilter-mcp-v1-0-0.xml
- Changelog JSON feed: https://verifymcp.io/servers/wyre-ai-dnsfilter-mcp/ghcr-io-wyre-ai-dnsfilter-mcp-v1-0-0.json
- HTML version of this page: https://verifymcp.io/servers/wyre-ai-dnsfilter-mcp/ghcr-io-wyre-ai-dnsfilter-mcp-v1-0-0
