Integration · Developer tools

Connect Claude & ChatGPT to DNSFilter

Ask your AI why a site is blocked, which domains were requested most this week, or what is waiting in the unblock queue, and it reads the answer from DNSFilter. It can search query logs, read threat and request totals, and block or allow domains and categories in your policies. Changes that loosen filtering can require your approval first.

Connect DNSFilter free

Free plan, no credit card. Takes about a minute.

Try asking

“Why is dropbox.com blocked for the sales team?”
The AI looks up how DNSFilter categorizes the domain and searches the query logs for blocked requests from that network.
“What were the most requested domains last week, and were any of them threats?”
It gets the top domains for the period, with a separate view of threats only.
“How many threats did we block per day this month?”
It reads the total blocked threats over the period, bucketed by day.

What your AI can do

Query logs and reports

Search DNS query logs, see top domains, and read total requests and blocked threats over time per network or agent.

Policies and block lists

Create and update policies, block or allow domains, block or unblock content categories, and look up how a domain is categorized.

Networks, agents and requests

Manage networks and read roaming clients, users, organizations and block pages, and decide on unblock requests.

“Block gambling sites in the Office policy.”
It finds the gambling category ID and blocks that category in the policy.
“What unblock requests are waiting?”
It lists open requests from users to unblock a site, and can allow or deny each one when you say so.
“Which roaming clients are offline?”
It lists installed DNSFilter agents filtered by status, with device, policy and version.

282 tools for DNSFilter

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

allow_domain_in_policyChanges dataAdd a domain to a policy's allow list so it is never blocked. Requires `policy_id`, `domain` and a `note`.
attach_dashboardChanges dataLink a dashboard (dashboard id).
block_category_in_policyChanges dataBlock a content category (for example gambling) in a policy. Requires `policy_id` and `category_id` from list_categories.
block_domain_in_policyChanges dataAdd a domain to a policy's block list. Requires `policy_id`, `domain` and a `note` explaining why.
cancelDeletesCancel a company (organization id). Destructive action; may require approval.
cancel_companyDeletesCancel a company (organization id). Destructive action; may require approval. API summary: Cancel suborganization.
cancel_mspDeletesCancel a msp (msp id). Destructive action; may require approval.
createChanges dataCreate a new address. Required: mac address. Search addresses first to avoid duplicates.
create_addressChanges dataCreate a new address. Required: ip address. Search addresses first to avoid duplicates.
create_api_keyChanges dataCreate a new api key. Search api keys first to avoid duplicates.
create_api_key_revokeChanges dataCreate a new revoke for a api key.
create_application_updateChanges dataCreate a new application update. Required: allow policies, application id, block policies or organization id. API summary: Update application.
create_billingChanges dataCreate a new billing. Required: organization id or payment token.
create_bulk_allowlist_domainsVisible to othersCreate a new bulk. Has effects visible outside this system. API summary: Bulk add allow.
create_bulk_blocklist_domainsVisible to othersCreate a new bulk. Has effects visible outside this system. API summary: Bulk add block.
create_bulk_createVisible to othersCreate a new bulk create. Has effects visible outside this system.
create_category_allowed_applicationChanges dataCreate a new category. Required: name. Search categories first to avoid duplicates. API summary: Add allow category.
create_category_blocked_applicationChanges dataCreate a new category. Required: name. Search categories first to avoid duplicates. API summary: Add block application.
create_category_permissive_modeChanges dataCreate a new permissive mode for a category. Required: permissive mode. API summary: Update permissive mode.
create_collection_userChanges dataCreate a new user for a collection. Required: body collection id or id. Search users first to avoid duplicates. API summary: Update.
create_companyChanges dataCreate a new company. Required: body. Search companies first to avoid duplicates. API summary: Create suborganization.
create_company_reactivateChanges dataCreate a new reactivate for a company. Required: body. API summary: Reactivate suborg.
create_company_skuChanges dataCreate a new company. Required: body. Search companies first to avoid duplicates. API summary: Add Sku.
create_company_userChanges dataCreate a new user for a company. Required: user. Search users first to avoid duplicates.
create_company_v1_networks_bulk_updateVisible to othersCreate a new company. Required: ids. Search companies first to avoid duplicates. Has effects visible outside this system. API summary: Bulk update.
create_company_v1_organizations_createChanges dataCreate a new company. Required: organization. Search companies first to avoid duplicates.
create_createChanges dataCreate a new create. Required: body report type, body start at or body end at.
create_dashboardChanges dataCreate a new dashboard. Required: dashboard.
create_dashboard_make_privateChanges dataCreate a new make private for a dashboard.
create_dashboard_make_publicChanges dataCreate a new make public for a dashboard.
create_dequeue_uninstallChanges dataCreate a new dequeue uninstall. Required: id. API summary: Remove queue.
create_enterprise_connectionChanges dataCreate a new enterprise connection. Required: organization id, strategy or options.
create_mspChanges dataCreate a new msp. Required: body.
create_msp_reactivateChanges dataCreate a new reactivate for a msp. Required: body.
create_networkChanges dataCreate a network (site). Pass `network` with a name, policy_ids, block_page_id and optional IP addresses.
create_network_secret_keyChanges dataCreate a new secret key for a network. API summary: Create Key.
create_network_subnetChanges dataCreate a new subnet for a network. Required: network subnet.
create_networks_csv_exportChanges dataCreate a new networks csv export.
create_pageChanges dataCreate a new page. Search pages first to avoid duplicates.
create_policyChanges dataCreate a filtering policy. Pass `policy` with a name, blacklist_categories, blacklist_domains, whitelist_domains and safe-search options.
create_promote_to_mspChanges dataCreate a new promote to msp.
create_scheduled_policyChanges dataCreate a new scheduled policy.
create_scheduled_reportChanges dataCreate a new scheduled report.
create_scheduled_report_previewChanges dataCreate a new scheduled report preview.
create_suggest_threatChanges dataCreate a new suggest threat. Required: fqdn or notes.
create_suppress_license_warningChanges dataCreate a new suppress license warning. Required: body. API summary: Suppresses license warning.
create_trialChanges dataCreate a new trial.
create_unblock_requests_csv_exportChanges dataCreate a new unblock requests csv export. API summary: Create an unblock-requests CSV export.
create_userVisible to othersCreate a new user. Search users first to avoid duplicates. Has effects visible outside this system.
create_user_membershipChanges dataCreate a new user. Required: body. Search users first to avoid duplicates. API summary: Add membership.
create_user_reset_password_urlDeletesCreate a new reset password url for a user. Destructive action; may require approval.
create_user_v1_distributors_users_createChanges dataCreate a new user. Required: body. Search users first to avoid duplicates. API summary: Create user.
create_user_v1_user_agent_bulk_deletes_createVisible to othersCreate a new user. Search users first to avoid duplicates. Has effects visible outside this system.
create_user_v1_user_agent_bulk_updates_createVisible to othersCreate a new user. Search users first to avoid duplicates. Has effects visible outside this system.
create_user_v1_user_agent_bulk_updates_has_mixedVisible to othersCreate a new user. Search users first to avoid duplicates. Has effects visible outside this system. API summary: Check agent values.
create_user_v1_user_agent_cleanups_createChanges dataCreate a new user. Required: organization ids or inactive for. Search users first to avoid duplicates.
create_user_v1_user_agent_csv_exports_createChanges dataCreate a new user. Search users first to avoid duplicates.
create_user_v2_agent_local_users_csv_export_createChanges dataCreate a new user. Search users first to avoid duplicates.
decide_unblock_requestChanges dataAllow or deny an unblock request by `unblock_request_id`. Set `decision` (allow, allow-universal, deny, deny-and-ignore or resolve-already-allowed); allowing adds the domain to the allow list, and `message` is sent to the requester on deny.
deleteDeletesPermanently delete a address by address id. Destructive action; may require approval.
delete_addressDeletesPermanently delete a address by address id. Destructive action; may require approval.
delete_api_keyDeletesPermanently delete a api key by api key id. Destructive action; may require approval.
delete_batch_destroysMoves moneyPermanently delete a batch destroy by note id. Financial or irreversible action; may require approval.
delete_bulk_destroysMoves moneyPermanently delete a bulk destroy. Financial or irreversible action; may require approval. API summary: Bulk Delete.
delete_bulks_allowlist_domainsMoves moneyPermanently delete a bulk. Financial or irreversible action; may require approval. API summary: Bulk delete allow.
delete_bulks_blocklist_domainsMoves moneyPermanently delete a bulk. Financial or irreversible action; may require approval. API summary: Bulk delete block.
delete_categoryDeletesPermanently delete a category by category id. Destructive action; may require approval.
delete_category_allowed_applicationDeletesPermanently delete a category by policy id. Destructive action; may require approval. API summary: Remove allow category.
delete_category_blocked_applicationDeletesPermanently delete a category by policy id. Destructive action; may require approval. API summary: Remove block application.
delete_collection_userDeletesPermanently delete a user by user id. Destructive action; may require approval. API summary: Delete user.
delete_companyDeletesPermanently delete a company by company id. Destructive action; may require approval. API summary: Delete MSP.
delete_company_skuDeletesPermanently delete a company by organization id. Destructive action; may require approval. API summary: Remove Sku.
delete_company_userDeletesPermanently delete a user by user id. Destructive action; may require approval.
delete_dashboardDeletesPermanently delete a dashboard by dashboard id. Destructive action; may require approval.
delete_enterprise_connectionDeletesPermanently delete a enterprise connection by enterprise connection id. Destructive action; may require approval.
delete_messageDeletesPermanently delete a message by domain. Destructive action; may require approval.
delete_networkDeletesPermanently delete a network by network id. Destructive action; may require approval.
delete_network_secret_keysMoves moneyPermanently delete a secret key by network id. Financial or irreversible action; may require approval. API summary: Delete Key.
delete_network_subnetDeletesPermanently delete a subnet by subnet id. Destructive action; may require approval.
delete_pageDeletesPermanently delete a page by page id. Destructive action; may require approval.
delete_scheduled_policyDeletesPermanently delete a scheduled policy by scheduled policy id. Destructive action; may require approval.
delete_scheduled_reportDeletesPermanently delete a scheduled report by scheduled report id. Destructive action; may require approval.
delete_userDeletesPermanently delete a user by user id. Destructive action; may require approval.
delete_user_membershipDeletesPermanently delete a user by user id. Destructive action; may require approval. API summary: Remove membership.
delete_user_v1_user_agents_destroyDeletesPermanently delete a user by user id. Destructive action; may require approval.
detach_dashboardChanges dataUnlink a dashboard (dashboard id).
disallow_domain_in_policyDeletesRemove a domain from a policy's allow list. Requires `policy_id`, `domain` and a `note`.
get_addressGet one address by organization id. API summary: Show address.
get_address_v1_ip_addresses_showGet one address by address id. API summary: Show IP.
get_address_v1_mac_addresses_showGet one address by address id. API summary: Show address.
get_address_verifyGet one address. API summary: Verify IP.
get_allList pages. Optional filters: organization id. Results are paginated. API summary: Get all.
get_all_agentsSearch pages by agent local user uuids, cybersight enabled, end at, network ids, organization id or search. Use this to find existing pages before creating a new page. Results are paginated. API summary: Get all agents.
get_all_mspList pages. Optional filters: count network ips, force truncate ips, organization id, protected or unprotected. Results are paginated. API summary: Get all MSP.
get_api_keyGet one api key by api key id. API summary: Show.
get_applicationGet one application by application id. API summary: Show.
get_bulk_createGet one bulk create by bulk create id. API summary: Bulk create status.
get_bulk_destroyGet one bulk destroy by bulk destroy id. API summary: Bulk delete status.
get_by_ipSearch networks by requesting ip address. Use this to find existing networks before creating a new network. API summary: Get by IP.
get_categoryGet one category by category id. API summary: Show category.
get_category_v1_categories_showGet one category by category id. API summary: Show category.
get_collection_userGet one user for a collection by user id. API summary: Show user.
get_companyGet one company by company id. API summary: Show Organization.
get_company_userGet one user for a company by user id. API summary: Show user.
get_company_v1_networks_bulk_update_statusGet one company by company id. API summary: Bulk update status.
get_company_v1_organizations_showGet one company by company id. API summary: Show organization.
get_csv_exportGet one csv export by csv export id. API summary: Show.
get_current_userGet the connected DNSFilter user and their organization. Use to confirm which account you are working in.
get_enterprise_connectionGet one enterprise connection by enterprise connection id. API summary: Show connection.
get_extant_mspList msps. Optional filters: basic info, count network ips, force truncate ips, organization id, protected or unprotected. Results are paginated. API summary: Get extant MSP.
get_invoiceGet one invoice by invoice id. API summary: Get invoice.
get_messageGet one message by domain. API summary: Show.
get_mspGet one msp by msp id. API summary: Show MSP.
get_networkGet one network by `network_id`, with its IP addresses, policies and block page.
get_network_lan_ipGet one lan ip for a network by lan ip id. API summary: Show Lan IP.
get_network_subnetGet one subnet for a network by subnet id. API summary: Show subnet.
get_networks_csv_exportGet one networks csv export by networks csv export id. API summary: Show.
get_organization_usageGet one organization usage by organization usage id. API summary: Get usage.
get_organization_usage_detailedGet one organization usage detailed by organization usage detailed id. API summary: Get usage detailed.
get_pageGet one page by page id. API summary: Show page.
get_policyGet one filtering policy by `category_id` (the policy ID), with its blocked categories, allow list and block list.
get_policy_ipGet one policy ip by policy ip id. API summary: Show IP.
get_roaming_clientGet one roaming client by `user_id` (the agent ID), with its device, policy, version and status.
get_scheduled_policyGet one scheduled policy by scheduled policy id. API summary: Show policy.
get_scheduled_reportGet one scheduled report by scheduled report id. API summary: Show report.
get_scheduled_report_previewGet one scheduled report preview by scheduled report preview id. API summary: Show preview.
get_top_domainsGet the most requested domains between `from` and `to`, optionally only threats (`security_report`) or by network, user or category.
get_total_requestsGet total DNS request counts over time between `from` and `to`, bucketed by `bucket_size`, optionally per network or agent.
get_total_threatsGet total blocked threat counts over time between `from` and `to`, optionally per network or agent.
get_ui_settingsList users. API summary: Get UI Settings.
get_unblock_requestGet one unblock request by unblock request id. API summary: Action drawer.
get_unblock_requests_csv_exportGet one unblock requests csv export by unblock requests csv export id. API summary: Poll an unblock-requests CSV export.
get_userGet one user by user id. API summary: Show bulk delete.
get_user_info_by_dateList companies. Optional filters: from, include in trial, include parent organization, msp ids, organization ids or to. API summary: Get user info by date.
get_user_v1_agent_local_users_showGet one user by user id. API summary: Show extant user.
get_user_v1_distributors_users_showGet one user by user id. API summary: Show User.
get_user_v1_user_agent_bulk_deletes_showGet one user by user id. API summary: Show.
get_user_v1_user_agent_bulk_updates_showGet one user by user id. API summary: Show.
get_user_v1_user_agent_cleanups_showGet one user by user id. API summary: Show.
get_user_v1_user_agent_csv_exports_showGet one user by user id. API summary: Show.
get_user_v1_users_showGet one user by user id. API summary: Show user.
get_user_v2_agent_local_users_csv_export_showGet one user by user id. API summary: Show.
list_addressesList addresses. Optional filters: organization ids. Results are paginated. API summary: Get extant.
list_applicationsList applications. Optional filters: category ids. Results are paginated. API summary: Get extant.
list_availablesList availables. API summary: Available Dashboards.
list_billingsList billings. Optional filters: organization id. API summary: Show.
list_block_pagesList block pages (the page shown when a site is blocked), optionally for one `organization_id`.
list_categoriesList DNSFilter content categories with their IDs, for use in policies and reports.
list_categories_2List categories. Results are paginated. API summary: Get extant.
list_categories_v1_traffic_reports_total_categoriesList categories. Optional filters: agent ids, agent types, application ids, bucket size, collection ids or from. API summary: Total category requests.
list_categories_v1_traffic_reports_total_requests_collectionsList categories. Optional filters: agent ids, agent types, application ids, bucket size, collection ids or from. API summary: Total requests collections.
list_category_permissive_modesList permissive modes for a category. API summary: Get permissive mode.
list_companiesList companies. Optional filters: date, include in trial, include parent organization, msp ids or organization ids. API summary: Get usage info.
list_companies_v1_traffic_reports_qps_active_organizationsList companies. Optional filters: agent ids, agent types, application ids, collection ids, from or mac addresses. API summary: QPS organizations.
list_companies_v1_traffic_reports_total_categories_organizationsList companies. Optional filters: agent ids, agent types, application ids, bucket size, collection ids or from. API summary: Category reqs organizations.
list_companies_v1_traffic_reports_total_domains_organizationsList companies. Optional filters: agent ids, agent types, application ids, bucket size, category ids or collection ids. API summary: Domain reqs organizations.
list_companies_v1_traffic_reports_total_requests_organizationsList companies. Optional filters: agent ids, agent types, application ids, bucket size, collection ids or from. API summary: Total requests/organizations.
list_companies_v1_traffic_reports_total_threats_organizationsList companies. Optional filters: agent ids, agent types, application ids, bucket size, collection ids or from. API summary: Total threats organizations.
list_company_usersList users for a company. Optional filters: include auth providers. API summary: Get.
list_csvsList csvs. Optional filters: include suborgs, organization id or timezone. API summary: CSV Export.
list_currentsList currents. API summary: Get current invoice.
list_customersList customers. Optional filters: msp id or organization id. API summary: Roaming clients.
list_dashboardsList dashboards. API summary: User's Dashboards.
list_distributorsList distributors. API summary: Get.
list_enterprise_connectionsList enterprise connections. Optional filters: organization id. API summary: Get extant.
list_geosList geos. API summary: Get Geo.
list_healthsList healths. API summary: Health Check.
list_invoicesList invoices. Optional filters: organization id. API summary: Get invoices.
list_mspsList msps. Optional filters: canceled at from, canceled at to, created at from, created at to, distributor id or distributor sku. Results are paginated. API summary: MSP Search.
list_myipsList myips. API summary: Get my IP.
list_network_lan_ipsList lan ips for a network. Results are paginated. API summary: Get.
list_network_subnetsList subnets for a network. Results are paginated. API summary: Get extant.
list_networksList networks (sites), with optional `search` text and protected/unprotected filters. Returns network IDs, names and assigned policies.
list_organizationsList the organizations you can manage, optionally filtered by `name`. Returns organization IDs for other tools.
list_ownedsList owneds. API summary: Owned Dashboards.
list_pagesList pages. Optional filters: category ids. Results are paginated. API summary: Get all.
list_pages_v1_categories_allList pages. Results are paginated. API summary: Get all.
list_pages_v1_ip_addresses_allList pages. Results are paginated. API summary: Get all.
list_pages_v1_mac_addresses_allList pages. Optional filters: organization ids. Results are paginated. API summary: Get all.
list_pages_v1_policies_allList pages. Optional filters: include global policies or organization id. Results are paginated. API summary: Get all.
list_pages_v1_scheduled_policies_allList pages. Results are paginated. API summary: Get all.
list_pages_v1_users_allList pages. Results are paginated. API summary: Get all.
list_pending_countsList pending counts. Optional filters: msp id, organization id or organization ids.
list_policiesList filtering policies, optionally for one `organization_id`. Returns policy IDs, names and settings.
list_policy_ipsList policy ips. API summary: Get.
list_productsList products. Optional filters: date, include in trial, include parent organization, msp ids or organization ids. API summary: Get usage info by SKU.
list_qpsList qps. Optional filters: agent ids, agent types, application ids, bucket size, collection ids or from. API summary: Queries per second.
list_qps_active_agentsList qps active agents. Optional filters: agent ids, agent types, application ids, collection ids, from or mac addresses. API summary: QPS clients.
list_redirect_linksList redirect links. Optional filters: organization id or psa name. API summary: Create link.
list_relaysList relays. API summary: Get relay.
list_roaming_clientsList roaming clients (installed DNSFilter agents) with filters such as `search`, `status`, `policy_id`, `network_ids` or `tags`.
list_scheduled_policiesList scheduled policies. Results are paginated. API summary: Get extant.
list_scheduled_reportsList scheduled reports. Optional filters: organization id. API summary: Get.
list_skus_availablesList skus availables.
list_subnetsList subnets. Optional filters: organization id. API summary: Get all.
list_tagsList tags. Optional filters: include used only, msp id, network ids or organization ids. API summary: Get tags.
list_top_organizations_requestsList top organizations requests. Optional filters: bucket size, from, msp id, organization id or to. Results are paginated.
list_total_category_statsList total category stats. Optional filters: category ids, from, msp id, network ids, organization id or to.
list_total_client_statsList total client stats. Optional filters: from, msp id, network ids, organization id or to.
list_total_deploymentsList total deployments. Optional filters: msp id, network ids or organization id.
list_total_domain_statsList total domain stats. Optional filters: domain, fqdn, from, msp id, network ids or organization id.
list_total_domainsList total domains. Optional filters: agent ids, agent types, application ids, bucket size, category ids or collection ids. API summary: Total domain reqs.
list_total_requests_agentsList total requests agents. Optional filters: agent ids, agent types, application ids, bucket size, collection ids or from. API summary: Total requests clients.
list_total_requests_geosList total requests geos. Optional filters: from, msp id, organization ids or to. Results are paginated.
list_unblock_requestsList requests from users to unblock a site, filterable by status, domain, email or organization.
list_uninstall_pinsList uninstall pins. Optional filters: organization id.
list_user_agent_releasesList user agent releases. API summary: Get.
list_usersList dashboard users in your DNSFilter account.
list_users_2List users. Optional filters: id. API summary: Count.
list_users_v1_networks_countsList users. Optional filters: msp id or organization ids. API summary: Counts.
list_users_v1_traffic_reports_total_domains_usersList users. Optional filters: agent ids, agent types, application ids, bucket size, category ids or collection ids. API summary: Domain reqs users.
list_users_v1_traffic_reports_total_requests_usersList users. Optional filters: agent ids, agent types, application ids, bucket size, collection ids or from. API summary: Total requests users.
list_users_v1_traffic_reports_total_threats_usersList users. Optional filters: agent ids, agent types, application ids, bucket size, collection ids or from. API summary: Total threats users.
list_users_v2_unblock_requests_countsList users. Optional filters: msp id, organization id or organization ids. API summary: Unblock request tab counts.
lookup_domainLook up how DNSFilter categorizes a domain, by `fqdn`. Use to explain why a site is blocked.
search_addressesSearch addresses by search. Use this to find existing addresses before creating a new address. Results are paginated. API summary: Get extant.
search_ai_applicationsSearch ai applications. Use this to find existing ai applications before creating a new ai application.
search_api_keysSearch api keys by expired, id, last four, name or organization id. Use this to find existing api keys before creating a new api key. API summary: List.
search_applicationsSearch applications by application id, name, organization id or policy ids. Use this to find existing applications before creating a new application. API summary: Get application.
search_bulk_lookupsSearch bulk lookups by fqdns. Use this to find existing bulk lookups before creating a new bulk lookup.
search_categoriesSearch categories by agent ids, agent types, application ids, collection ids, from or mac addresses. Use this to find existing categories before creating a new category. Results are paginated. API summary: Top categories.
search_categories_v1_traffic_reports_top_application_categoriesSearch categories by agent ids, agent types, application ids, collection ids, from or mac addresses. Use this to find existing categories before creating a new category. Results are paginated. API summary: Top application categories.
search_categories_v1_traffic_reports_top_collectionsSearch categories by agent ids, agent types, application ids, collection ids, from or mac addresses. Use this to find existing categories before creating a new category. Results are paginated. API summary: Top collections.
search_collection_usersSearch users for a collection by name or sort. Use this to find existing users before creating a new user. Results are paginated. API summary: Gets collection users.
search_companiesSearch companies by canceled at from, canceled at to, created at from, created at to, distributor id or distributor sku. Use this to find existing companies before creating a new company. Results are paginated. API summary: Organizations Search.
search_cyber_sight_activity_typesSearch cyber sight activity types. Use this to find existing cyber sight activity types before creating a new cyber sight activity type. API summary: CyberSight Activity Types.
search_pagesSearch pages by cybersight enabled, end at, in a collection, name, organization ids or sort. Use this to find existing pages before creating a new page. Results are paginated. API summary: Gets ALL users.
search_pages_v1_networks_allSearch pages by basic info, count network ips, force truncate ips, protected, search or unprotected. Use this to find existing pages before creating a new page. Results are paginated. API summary: Get all.
search_pages_v1_organizations_allSearch pages by basic info, managed by msp id, name, owned msp id or type. Use this to find existing pages before creating a new page. Results are paginated. API summary: Get all.
search_qp_methodsSearch qp methods. Use this to find existing qp methods before creating a new qp method. API summary: List QP Methods.
search_query_logsSearch DNS query logs between `from` and `to`, filtered by `domain`/`fqdn`, `result` (allowed or blocked), network, user, agent or category.
search_settingsSearch settings by msp id, name, organization id or organization ids. Use this to find existing settings before creating a new setting. API summary: Get settings.
search_top_agentsSearch top agents by agent ids, agent types, application ids, collection ids, from or mac addresses. Use this to find existing top agents before creating a new top agent. Results are paginated.
search_top_networksSearch top networks by agent ids, agent types, application ids, collection ids, from or mac addresses. Use this to find existing top networks before creating a new top network. Results are paginated.
search_total_applications_agents_statsSearch total applications agents stats by agent ids, agent types, application category ids, application ids, collection ids or from. Use this to find existing total applications agents stats before creating a new total applications agents stat. API summary: Application reqs clients.
search_total_applications_collections_statsSearch total applications collections stats by agent ids, agent types, application category ids, application ids, collection ids or from. Use this to find existing total applications collections stats before creating a new total applications collections stat. API summary: Application reqs collections.
search_total_applications_networks_statsSearch total applications networks stats by agent ids, agent types, application category ids, application ids, collection ids or from. Use this to find existing total applications networks stats before creating a new total applications networks stat. API summary: Applications reqs networks.
search_total_applications_statsSearch total applications stats by agent ids, agent types, application category ids, application ids, collection ids or from. Use this to find existing total applications stats before creating a new total applications stat. API summary: Application requests.
search_total_applications_users_statsSearch total applications users stats by agent ids, agent types, application category ids, application ids, collection ids or from. Use this to find existing total applications users stats before creating a new total applications users stat. API summary: Application reqs users.
search_total_organizations_requestsSearch total organizations requests by agent ids, agent types, application ids, bucket size, category ids or collection ids. Use this to find existing total organizations requests before creating a new total organizations request. API summary: Total Org Requests.
search_total_organizations_statsSearch total organizations stats by agent ids, agent types, application category ids, bucket size, collection ids or from. Use this to find existing total organizations stats before creating a new total organizations stat. API summary: Organization stats.
search_usersSearch users by block page, collection id, cybersight enabled, end at, friendly name or ids. Use this to find existing users before creating a new user. Results are paginated. API summary: Gets extant users.
search_users_v1_distributors_users_indexSearch users by created at from, created at to, distributor guid, email, first name or last name. Use this to find existing users before creating a new user. Results are paginated. API summary: Users Search.
search_users_v1_traffic_reports_top_usersSearch users by agent ids, agent types, application ids, collection ids, from or mac addresses. Use this to find existing users before creating a new user. Results are paginated. API summary: Top users.
search_users_v1_user_agent_bulk_deletes_countsSearch users by agent state, name search, network ids, organization id, search or state. Use this to find existing users before creating a new user. API summary: Counts.
search_users_v1_user_agent_bulk_updates_countsSearch users by agent state, block page id, name search, network ids, organization id or policy id. Use this to find existing users before creating a new user. API summary: Counts.
search_users_v1_user_agents_countsSearch users by msp id, name search, network ids, new agent states, organization ids or release channels. Use this to find existing users before creating a new user. API summary: Counts.
search_users_v2_agent_local_users_countsSearch users by msp id, name, organization ids or search. Use this to find existing users before creating a new user. API summary: Count users.
search_vpn_settings_state_typesSearch vpn settings state types. Use this to find existing vpn settings state types before creating a new vpn settings state type.
send_user_reset_password_emailDeletesSend a user (user id). Destructive action; may require approval. API summary: Reset password.
submit_msp_skusVisible to othersUpsert a msp (msp id). Has effects visible outside this system. API summary: Upsert SKUs.
submit_user_inviteVisible to othersResend a user (user id). Has effects visible outside this system. API summary: Resend Invite.
unblock_category_in_policyDeletesStop blocking a content category in a policy. Requires `policy_id` and `category_id`.
unblock_domain_in_policyDeletesRemove a domain from a policy's block list. Requires `policy_id`, `domain` and a `note`.
updateChanges dataUpdate an existing address identified by address id. Only the fields you pass are changed.
update_addressChanges dataUpdate an existing address identified by organization id. Only the fields you pass are changed. API summary: Update address.
update_address_v1_mac_addresses_updateChanges dataUpdate an existing address identified by address id. Only the fields you pass are changed.
update_change_passwordsMoves moneyUpdate an existing change password. Only the fields you pass are changed. Financial or irreversible action; may require approval.
update_companiesVisible to othersUpdate an existing company. Only the fields you pass are changed. Has effects visible outside this system. API summary: Bulk update.
update_companyChanges dataUpdate an existing company identified by company id. Only the fields you pass are changed. API summary: Update suborganization.
update_company_userChanges dataUpdate an existing user identified by user id. Only the fields you pass are changed.
update_dashboardChanges dataUpdate an existing dashboard identified by dashboard id. Only the fields you pass are changed.
update_distributorsVisible to othersUpdate an existing distributor. Only the fields you pass are changed. Has effects visible outside this system.
update_enterprise_connectionChanges dataUpdate an existing enterprise connection identified by enterprise connection id. Only the fields you pass are changed.
update_messageChanges dataUpdate an existing message identified by domain. Only the fields you pass are changed.
update_message_batch_updatesVisible to othersUpdate an existing batch update identified by note id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Bulk update.
update_mspChanges dataUpdate an existing msp identified by msp id. Only the fields you pass are changed.
update_networkChanges dataUpdate a network by `network_id`: name, policies, block page, local domains or IP addresses in `network`.
update_network_lan_ipChanges dataUpdate an existing lan ip identified by lan ip id. Only the fields you pass are changed.
update_network_secret_keysVisible to othersUpdate an existing secret key identified by network id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Rotate key.
update_network_subnetChanges dataUpdate an existing subnet identified by subnet id. Only the fields you pass are changed.
update_pageChanges dataUpdate an existing page identified by page id. Only the fields you pass are changed.
update_policyChanges dataUpdate a filtering policy by `category_id` (the policy ID). Only the fields passed in `policy` change.
update_scheduled_policyChanges dataUpdate an existing scheduled policy identified by scheduled policy id. Only the fields you pass are changed.
update_scheduled_reportChanges dataUpdate an existing scheduled report identified by scheduled report id. Only the fields you pass are changed.
update_ui_settingsVisible to othersUpdate an existing user. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update UI Settings.
update_userChanges dataUpdate an existing user identified by user id. Only the fields you pass are changed.
update_user_membershipChanges dataUpdate an existing user identified by user id. API summary: Update membership.
update_user_settingsChanges dataUpdate an existing user identified by user agent id. Only the fields you pass are changed. API summary: Update settings.
update_user_v1_user_agent_cleanups_updateChanges dataUpdate an existing user identified by user id.
update_user_v1_user_agents_updateChanges dataUpdate an existing user identified by user id. Only the fields you pass are changed.
update_usersVisible to othersUpdate an existing user. Only the fields you pass are changed. Has effects visible outside this system.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose DNSFilter from the app list.
2
Paste your key
Paste a DNSFilter API key. In the DNSFilter dashboard, open Account Settings and create an API key. HeyMyApps sends it as-is in the Authorization header.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in DNSFilter?

It can read networks, policies, categories, block pages, roaming clients, users, organizations and unblock requests, search query logs, look up a domain's category, and read top domains, total requests and total threats. It can create and update policies and networks, block or allow domains and categories in a policy, and allow or deny unblock requests.

Does the AI see my DNSFilter credentials?

No. Your DNSFilter credentials are encrypted at rest and never shown to the AI. After you save them, they are not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start with reports and lookups only. Tools that loosen filtering, such as unblocking a domain or category or removing a domain from an allow list, are marked higher risk and can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT, open Settings › Apps & Connectors › Advanced, turn on Developer mode and add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

HeyMyApps has a free plan with no credit card required. Paid plans bill per completed task. You also need your own DNSFilter account.

Can the AI explain why a site was blocked?

Yes. It can look up how DNSFilter categorizes a domain, read the policy that applies with its blocked categories and block list, and search the query logs for that domain. That usually shows whether a category or a block list entry caused the block.