LAN-hosted MCP server for safely querying and managing OPNsense Dnsmasq DHCP state through the official OPNsense API
Quick Install
Copy the config for your editor. Some servers may need additional setup — check the README.
Claude Desktop
Claude Code
Cursor
Add to claude_desktop_config.json:
{
"mcpServers": {
"mcp-opnsense-dnsmasq": {
"command": "npx",
"args": [
"-y",
"Slyke/mcp-opnsense-dnsmasq"
]
}
}
}
📋 Copy
Run in terminal:
claude mcp add mcp-opnsense-dnsmasq npx -y Slyke/mcp-opnsense-dnsmasq
📋 Copy
Add to .cursor/mcp.json:
{
"mcpServers": {
"mcp-opnsense-dnsmasq": {
"command": "npx",
"args": [
"-y",
"Slyke/mcp-opnsense-dnsmasq"
]
}
}
}
📋 Copy
README Excerpt
LAN-hosted MCP server for safely querying and managing OPNsense Dnsmasq DHCP state through the official OPNsense API. Codex or other MCP clients authenticate to this server with named Bearer tokens; this server authenticates to OPNsense with API key/secret Basic Auth. OPNsense credentials are never exposed to MCP clients.
Tools (20)
MCP_READWRITE_BEARER_TOKENS MCP_READ_BEARER_TOKENS OPNSENSE_API_KEY OPNSENSE_BASE_URL admin1 arp_list arp_search client_summary dhcp_access_block dhcp_access_blocks_list dhcp_access_policy_get dhcp_access_policy_set dhcp_access_unblock dhcp_domains_delete dhcp_domains_get dhcp_domains_list dhcp_domains_search dhcp_domains_update dhcp_leases_search dhcp_options_get