DNSFilter MCP server
259 operations0 webhooks
Cloud DNS security and content filtering - manage networks, policies, roaming clients, block pages, and traffic reporting.
Try DNSFilter with your agent
Connect DNSFilter, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in DNSFilter on my account, then run one read-only example and show me the result.
DNSFilter tools and triggers
Tools are what your agent can do in DNSFilter through Corsair's MCP server. Triggers are the DNSFilter events a routine can start from.
Traffic Reports
- QpsRead-only
QPS for traffic reports
trafficReports.qps
- Qps Active AgentsRead-only
QPS active agents for traffic reports
trafficReports.qpsActiveAgents
- Qps Active OrganizationsRead-only
QPS active organizations for traffic reports
trafficReports.qpsActiveOrganizations
- Query LogsRead-only
Query logs for traffic reports
trafficReports.queryLogs
- Top AgentsRead-only
Top agents for traffic reports
trafficReports.topAgents
- Top Application CategoriesRead-only
Top application categories for traffic reports
trafficReports.topApplicationCategories
- Top CategoriesRead-only
Top categories for traffic reports
trafficReports.topCategories
- Top CollectionsRead-only
Top collections for traffic reports
trafficReports.topCollections
- Top DomainsRead-only
Top domains for traffic reports
trafficReports.topDomains
- Top NetworksRead-only
Top networks for traffic reports
trafficReports.topNetworks
- Top Organizations RequestsRead-only
Top organizations requests for traffic reports
trafficReports.topOrganizationsRequests
- Top UsersRead-only
Top users for traffic reports
trafficReports.topUsers
- Total Applications Agents StatsRead-only
Total applications agents stats for traffic reports
trafficReports.totalApplicationsAgentsStats
- Total Applications Collections StatsRead-only
Total applications collections stats for traffic reports
trafficReports.totalApplicationsCollectionsStats
- Total Applications Networks StatsRead-only
Total applications networks stats for traffic reports
trafficReports.totalApplicationsNetworksStats
- Total Applications StatsRead-only
Total applications stats for traffic reports
trafficReports.totalApplicationsStats
- Total Applications Users StatsRead-only
Total applications users stats for traffic reports
trafficReports.totalApplicationsUsersStats
- Total CategoriesRead-only
Total categories for traffic reports
trafficReports.totalCategories
- Total Categories OrganizationsRead-only
Total categories organizations for traffic reports
trafficReports.totalCategoriesOrganizations
- Total Category StatsRead-only
Total category stats for traffic reports
trafficReports.totalCategoryStats
- Total Client StatsRead-only
Total client stats for traffic reports
trafficReports.totalClientStats
- Total DeploymentsRead-only
Total deployments for traffic reports
trafficReports.totalDeployments
- Total Domain StatsRead-only
Total domain stats for traffic reports
trafficReports.totalDomainStats
- Total DomainsRead-only
Total domains for traffic reports
trafficReports.totalDomains
- Total Domains OrganizationsRead-only
Total domains organizations for traffic reports
trafficReports.totalDomainsOrganizations
- Total Domains UsersRead-only
Total domains users for traffic reports
trafficReports.totalDomainsUsers
- Total Organizations RequestsRead-only
Total organizations requests for traffic reports
trafficReports.totalOrganizationsRequests
- Total Organizations StatsRead-only
Total organizations stats for traffic reports
trafficReports.totalOrganizationsStats
- Total RequestsRead-only
Total requests for traffic reports
trafficReports.totalRequests
- Total Requests AgentsRead-only
Total requests agents for traffic reports
trafficReports.totalRequestsAgents
- Total Requests CollectionsRead-only
Total requests collections for traffic reports
trafficReports.totalRequestsCollections
- Total Requests GeoRead-only
Total requests geo for traffic reports
trafficReports.totalRequestsGeo
- Total Requests OrganizationsRead-only
Total requests organizations for traffic reports
trafficReports.totalRequestsOrganizations
- Total Requests UsersRead-only
Total requests users for traffic reports
trafficReports.totalRequestsUsers
- Total Roaming ClientsRead-only
Total roaming clients for traffic reports
trafficReports.totalRoamingClients
- Total ThreatsRead-only
Total threats for traffic reports
trafficReports.totalThreats
- Total Threats OrganizationsRead-only
Total threats organizations for traffic reports
trafficReports.totalThreatsOrganizations
- Total Threats UsersRead-only
Total threats users for traffic reports
trafficReports.totalThreatsUsers
Networks
- Bulk CreateWrite
Bulk create for networks
networks.bulkCreate
- Bulk Create StatusRead-only
Bulk create status for networks
networks.bulkCreateStatus
- Bulk DestroyDestructive
Bulk destroy for networks
networks.bulkDestroy
- Bulk Destroy StatusRead-only
Bulk destroy status for networks
networks.bulkDestroyStatus
- Bulk UpdateWrite
Bulk update for networks
networks.bulkUpdate
- Bulk Update StatusRead-only
Bulk update status for networks
networks.bulkUpdateStatus
- CountsRead-only
Counts for networks
networks.counts
- CreateWrite
Create a network
networks.create
- DeleteDestructive
Delete a network
networks.delete
- Generate Secret KeyWrite
Generate secret key for networks
networks.generateSecretKey
- GeoRead-only
Geo for networks
networks.geo
- GetRead-only
Get a network
networks.get
- ListRead-only
List networks
networks.list
- List AllRead-only
List all networks
networks.listAll
- LookupRead-only
Lookup for networks
networks.lookup
- MspRead-only
List MSP networks
networks.msp
- Msp AllRead-only
List all MSP networks
networks.mspAll
- Revoke Secret KeyDestructive
Revoke secret key for networks
networks.revokeSecretKey
- Rotate Secret KeyWrite
Rotate secret key for networks
networks.rotateSecretKey
- UpdateWrite
Update a network
networks.update
Policies
- Add Allowed ApplicationWrite
Add allowed application for policies
policies.addAllowedApplication
- Add Blacklist CategoryWrite
Add blacklist category for policies
policies.addBlacklistCategory
- Add Blacklist DomainWrite
Add blacklist domain for policies
policies.addBlacklistDomain
- Add Blocked ApplicationWrite
Add blocked application for policies
policies.addBlockedApplication
- Add Whitelist DomainWrite
Add whitelist domain for policies
policies.addWhitelistDomain
- ApplicationRead-only
Application for policies
policies.application
- Application UpdateWrite
Application update for policies
policies.applicationUpdate
- CreateWrite
Create a policy
policies.create
- DeleteDestructive
Delete a policy
policies.delete
- GetRead-only
Get a policy
policies.get
- Get Permissive ModeRead-only
Get permissive mode for policies
policies.getPermissiveMode
- ListRead-only
List policies
policies.list
- List AllRead-only
List all policies
policies.listAll
- Remove Allowed ApplicationWrite
Remove allowed application for policies
policies.removeAllowedApplication
- Remove Blacklist CategoryWrite
Remove blacklist category for policies
policies.removeBlacklistCategory
- Remove Blacklist DomainWrite
Remove blacklist domain for policies
policies.removeBlacklistDomain
- Remove Blocked ApplicationWrite
Remove blocked application for policies
policies.removeBlockedApplication
- Remove Whitelist DomainWrite
Remove whitelist domain for policies
policies.removeWhitelistDomain
- UpdateWrite
Update a policy
policies.update
- Update Permissive ModeWrite
Update permissive mode for policies
policies.updatePermissiveMode
Csv Exports
- Agent Local Users CreateWrite
Create agent local users CSV export
csvExports.agentLocalUsersCreate
- Agent Local Users GetRead-only
Get agent local users CSV export
csvExports.agentLocalUsersGet
- Cyber Sight CreateWrite
Create CyberSight CSV export
csvExports.cyberSightCreate
- Cyber Sight GetRead-only
Get CyberSight CSV export
csvExports.cyberSightGet
- Networks CreateWrite
Create networks CSV export
csvExports.networksCreate
- Networks GetRead-only
Get networks CSV export
csvExports.networksGet
- Unblock Requests CreateWrite
Create unblock requests CSV export
csvExports.unblockRequestsCreate
- Unblock Requests GetRead-only
Get unblock requests CSV export
csvExports.unblockRequestsGet
- User Agent CreateWrite
Create user agent CSV export
csvExports.userAgentCreate
- User Agent GetRead-only
Get user agent CSV export
csvExports.userAgentGet
- User Agents CsvRead-only
Download user agents CSV
csvExports.userAgentsCsv
Dashboards
- AvailableRead-only
Available for dashboards
dashboards.available
- CreateWrite
Create a dashboard
dashboards.create
- DeleteDestructive
Delete a dashboard
dashboards.delete
- LinkWrite
Link for dashboards
dashboards.link
- ListRead-only
List dashboards
dashboards.list
- Make PrivateWrite
Make private for dashboards
dashboards.makePrivate
- Make PublicWrite
Make public for dashboards
dashboards.makePublic
- OwnedRead-only
Owned for dashboards
dashboards.owned
- UnlinkWrite
Unlink for dashboards
dashboards.unlink
- UpdateWrite
Update a dashboard
dashboards.update
Organizations
- Bulk UpdateWrite
Bulk update for organizations
organizations.bulkUpdate
- CancelDestructive
Cancel an organization
organizations.cancel
- CreateWrite
Create an organization
organizations.create
- DeleteDestructive
Delete an organization
organizations.delete
- GetRead-only
Get an organization
organizations.get
- ListRead-only
List organizations
organizations.list
- List AllRead-only
List all organizations
organizations.listAll
- Promote To MspWrite
Promote to MSP for organizations
organizations.promoteToMsp
- SettingsRead-only
Settings for organizations
organizations.settings
- UpdateWrite
Update an organization
organizations.update
User Agents
- CountsRead-only
Counts for user agents
userAgents.counts
- DeleteDestructive
Delete a user agent
userAgents.delete
- Dequeue UninstallWrite
Dequeue uninstall for user agents
userAgents.dequeueUninstall
- GetRead-only
Get a user agent
userAgents.get
- ListRead-only
List user agents
userAgents.list
- List AllRead-only
List all user agents
userAgents.listAll
- TagsRead-only
Tags for user agents
userAgents.tags
- Uninstall PinRead-only
Uninstall pin for user agents
userAgents.uninstallPin
- UpdateWrite
Update a user agent
userAgents.update
Ip Addresses
- CreateWrite
Create an IP address
ipAddresses.create
- DeleteDestructive
Delete an IP address
ipAddresses.delete
- GetRead-only
Get an IP address
ipAddresses.get
- ListRead-only
List IP addresses
ipAddresses.list
- List AllRead-only
List all IP addresses
ipAddresses.listAll
- MyipRead-only
My IP for IP addresses
ipAddresses.myip
- UpdateWrite
Update an IP address
ipAddresses.update
- VerifyRead-only
Verify for IP addresses
ipAddresses.verify
Block Pages
- CreateWrite
Create a block page
blockPages.create
- DeleteDestructive
Delete a block page
blockPages.delete
- GetRead-only
Get a block page
blockPages.get
- ListRead-only
List block pages
blockPages.list
- List AllRead-only
List all block pages
blockPages.listAll
- UpdateWrite
Update a block page
blockPages.update
Mac Addresses
- CreateWrite
Create a MAC address
macAddresses.create
- DeleteDestructive
Delete a MAC address
macAddresses.delete
- GetRead-only
Get a MAC address
macAddresses.get
- ListRead-only
List MAC addresses
macAddresses.list
- List AllRead-only
List all MAC addresses
macAddresses.listAll
- UpdateWrite
Update a MAC address
macAddresses.update
Network Subnets
- CreateWrite
Create a network subnet
networkSubnets.create
- DeleteDestructive
Delete a network subnet
networkSubnets.delete
- GetRead-only
Get a network subnet
networkSubnets.get
- ListRead-only
List network subnets
networkSubnets.list
- List AllRead-only
List all network subnets
networkSubnets.listAll
- UpdateWrite
Update a network subnet
networkSubnets.update
Organization Users
- CreateWrite
Create an organization user
organizationUsers.create
- DeleteDestructive
Delete an organization user
organizationUsers.delete
- GetRead-only
Get an organization user
organizationUsers.get
- ListRead-only
List organization users
organizationUsers.list
- Resend InviteWrite
Resend invite for organization users
organizationUsers.resendInvite
- UpdateWrite
Update an organization user
organizationUsers.update
Scheduled Policies
- CreateWrite
Create a scheduled policy
scheduledPolicies.create
- DeleteDestructive
Delete a scheduled policy
scheduledPolicies.delete
- GetRead-only
Get a scheduled policy
scheduledPolicies.get
- ListRead-only
List scheduled policies
scheduledPolicies.list
- List AllRead-only
List all scheduled policies
scheduledPolicies.listAll
- UpdateWrite
Update a scheduled policy
scheduledPolicies.update
Scheduled Reports V2
- Bulk UpdateWrite
Bulk update for scheduled reports V2
scheduledReportsV2.bulkUpdate
- CreateWrite
Create a scheduled reports V2
scheduledReportsV2.create
- DeleteDestructive
Delete a scheduled reports V2
scheduledReportsV2.delete
- GetRead-only
Get a scheduled reports V2
scheduledReportsV2.get
- ListRead-only
List scheduled reports V2
scheduledReportsV2.list
- UpdateWrite
Update a scheduled reports V2
scheduledReportsV2.update
Agent Local Users
- DeleteDestructive
Delete an agent local user
agentLocalUsers.delete
- GetRead-only
Get an agent local user
agentLocalUsers.get
- ListRead-only
List agent local users
agentLocalUsers.list
- List AllRead-only
List all agent local users
agentLocalUsers.listAll
- UpdateWrite
Update an agent local user
agentLocalUsers.update
Api Keys
- CreateWrite
Create an API key
apiKeys.create
- DeleteDestructive
Delete an API key
apiKeys.delete
- GetRead-only
Get an API key
apiKeys.get
- ListRead-only
List API keys
apiKeys.list
- RevokeDestructive
Revoke an API key
apiKeys.revoke
Domain Notes
- Batch DestroyDestructive
Batch destroy for domain notes
domainNotes.batchDestroy
- Batch UpdateWrite
Batch update for domain notes
domainNotes.batchUpdate
- DeleteDestructive
Delete a domain note
domainNotes.delete
- GetRead-only
Get a domain note
domainNotes.get
- UpdateWrite
Update a domain note
domainNotes.update
Enterprise Connections
- CreateWrite
Create an enterprise connection
enterpriseConnections.create
- DeleteDestructive
Delete an enterprise connection
enterpriseConnections.delete
- GetRead-only
Get an enterprise connection
enterpriseConnections.get
- ListRead-only
List enterprise connections
enterpriseConnections.list
- UpdateWrite
Update an enterprise connection
enterpriseConnections.update
Scheduled Reports
- CreateWrite
Create a scheduled report
scheduledReports.create
- DeleteDestructive
Delete a scheduled report
scheduledReports.delete
- GetRead-only
Get a scheduled report
scheduledReports.get
- ListRead-only
List scheduled reports
scheduledReports.list
- UpdateWrite
Update a scheduled report
scheduledReports.update
Unblock Requests
- CountsRead-only
Counts for unblock requests
unblockRequests.counts
- DecisionWrite
Decision for unblock requests
unblockRequests.decision
- GetRead-only
Get an unblock request
unblockRequests.get
- ListRead-only
List unblock requests
unblockRequests.list
- Pending CountRead-only
Pending count for unblock requests
unblockRequests.pendingCount
Billings
- Address ShowRead-only
Address show for billings
billings.addressShow
- Address UpdateWrite
Address update for billings
billings.addressUpdate
- CreateWrite
Create a billing
billings.create
- GetRead-only
Get a billing
billings.get
Collection Users
- CreateWrite
Create a collection user
collectionUsers.create
- DeleteDestructive
Delete a collection user
collectionUsers.delete
- GetRead-only
Get a collection user
collectionUsers.get
- ListRead-only
List collection users
collectionUsers.list
Policies Bulk Actions
- Add Allowlist DomainsWrite
Add allowlist domains for policies bulk actions
policiesBulkActions.addAllowlistDomains
- Add Blocklist DomainsWrite
Add blocklist domains for policies bulk actions
policiesBulkActions.addBlocklistDomains
- Remove Allowlist DomainsWrite
Remove allowlist domains for policies bulk actions
policiesBulkActions.removeAllowlistDomains
- Remove Blocklist DomainsWrite
Remove blocklist domains for policies bulk actions
policiesBulkActions.removeBlocklistDomains
User Agent Bulk Updates
- CountsRead-only
Counts for user agent bulk updates
userAgentBulkUpdates.counts
- CreateWrite
Bulk update user agent
userAgentBulkUpdates.create
- GetRead-only
Get a user agent bulk update
userAgentBulkUpdates.get
- Has MixedWrite
Has mixed for user agent bulk updates
userAgentBulkUpdates.hasMixed
Users
- Change PasswordWrite
Change password for users
users.changePassword
- GetRead-only
Get a user
users.get
- ListRead-only
List users
users.list
- List AllRead-only
List all users
users.listAll
Agent Local User Bulk Deletes
- CountsRead-only
Counts for agent local user bulk deletes
agentLocalUserBulkDeletes.counts
- CreateDestructive
Bulk delete agent local user
agentLocalUserBulkDeletes.create
- GetRead-only
Get an agent local user bulk delete
agentLocalUserBulkDeletes.get
Applications
- GetRead-only
Get an application
applications.get
- ListRead-only
List applications
applications.list
- List AllRead-only
List all applications
applications.listAll
Categories
- GetRead-only
Get a category
categories.get
- ListRead-only
List categories
categories.list
- List AllRead-only
List all categories
categories.listAll
Dictionary V2
- Ai ApplicationsRead-only
AI applications for dictionary V2
dictionaryV2.aiApplications
- Cyber Sight Activity TypesRead-only
Cyber sight activity types for dictionary V2
dictionaryV2.cyberSightActivityTypes
- Vpn Settings State TypesRead-only
Vpn settings state types for dictionary V2
dictionaryV2.vpnSettingsStateTypes
Domains
- Bulk LookupRead-only
Bulk lookup for domains
domains.bulkLookup
- Suggest ThreatWrite
Suggest threat for domains
domains.suggestThreat
- User LookupRead-only
User lookup for domains
domains.userLookup
Invoices
- CurrentRead-only
Current for invoices
invoices.current
- GetRead-only
Get an invoice
invoices.get
- ListRead-only
List invoices
invoices.list
Network Lan Ips
- GetRead-only
Get a network LAN IP
networkLanIps.get
- ListRead-only
List network LAN IPs
networkLanIps.list
- UpdateWrite
Update a network LAN IP
networkLanIps.update
User Agent Bulk Deletes
- CountsRead-only
Counts for user agent bulk deletes
userAgentBulkDeletes.counts
- CreateDestructive
Bulk delete user agent
userAgentBulkDeletes.create
- GetRead-only
Get a user agent bulk delete
userAgentBulkDeletes.get
User Agent Cleanups
- CreateDestructive
Clean up user agent
userAgentCleanups.create
- GetRead-only
Get a user agent cleanup
userAgentCleanups.get
- UpdateDestructive
Update a user agent cleanup
userAgentCleanups.update
Application Categories
- GetRead-only
Get an application category
applicationCategories.get
- ListRead-only
List application categories
applicationCategories.list
Current User Ui Settings
- GetRead-only
Get a current user UI setting
currentUserUiSettings.get
- UpdateWrite
Update a current user UI setting
currentUserUiSettings.update
Current Users
- GetRead-only
Get a current user
currentUsers.get
- UpdateWrite
Update a current user
currentUsers.update
Metrics
- Organization UsageRead-only
Organization usage for metrics
metrics.organizationUsage
- Organization Usage DetailedRead-only
Organization usage detailed for metrics
metrics.organizationUsageDetailed
Policy Ips
- GetRead-only
Get a policy IP
policyIps.get
- ListRead-only
List policy IPs
policyIps.list
Scheduled Report Previews
- CreateWrite
Create a scheduled report preview
scheduledReportPreviews.create
- GetRead-only
Get a scheduled report preview
scheduledReportPreviews.get
User Agent Releases
- ListRead-only
List user agent releases
userAgentReleases.list
- RelayRead-only
Relay for user agent releases
userAgentReleases.relay
Agent Local Users V2
- CountsRead-only
Counts for agent local users V2
agentLocalUsersV2.counts
Current User Org Ui Settings
- Suppress License WarningWrite
Suppress license warning for current user org UI settings
currentUserOrgUiSettings.suppressLicenseWarning
Dictionary
- Qp MethodsRead-only
QP methods for dictionary
dictionary.qpMethods
Psa Integrations
- Redirect LinkRead-only
Redirect link for PSA integrations
psaIntegrations.redirectLink
Trials
- CreateWrite
Create a trial
trials.create
User Agents V2
- Update SettingsWrite
Update settings for user agents V2
userAgentsV2.updateSettings
Connect DNSFilter to Claude, ChatGPT or Cursor
- 1
Connect DNSFilter in Corsair
Add your DNSFilter API key once in Corsair. Corsair stores the credential encrypted and makes the DNSFilter API calls for your agent, so it never goes into a prompt or a config file. Connect DNSFilter
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs DNSFilter. On a ChatGPT personal plan, connect DNSFilter here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, DNSFilter's read and write operations run right away and its 27 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/dnsfilter, add the DNSFilter plugin, and connect with an API key. Then call methods like corsair.dnsfilter.api.agentLocalUserBulkDeletes.counts() from your app. Corsair syncs data per tenant.
Yes. DNSFilter requires an API key from your DNSFilter account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit DNSFilter, GitHub, Notion, Stripe, and the rest. Trigger DNSFilter from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for cloud dns security and content filtering - manage networks, policies, roaming clients, block pages, and traffic reporting. Common builds include sync jobs, admin tooling, and agents that call DNSFilter APIs from your backend. Local DB entities let you query synced DNSFilter records without hitting the API on every read.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per DNSFilter API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/dnsfilter in the open repo. When DNSFilter ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your DNSFilter data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store DNSFilter data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put DNSFilter on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 27 destructive DNSFilter operations. You can change a link's mode at hub.corsair.dev/me.