mcp-infoblox

A Model Context Protocol (MCP) server for Infoblox NIOS, providing AI assistants with full access to DNS, DHCP, and IPAM management through the Infoblox WAPI REST API.

Features

35 tools across five categories:

DNS Record Management

Tool	Description
search_dns_records	Search for A, AAAA, CNAME, Host, PTR, MX, TXT, SRV records with regex support
get_all_records_in_zone	List all DNS records in a specific zone
create_a_record	Create a DNS A record
create_aaaa_record	Create a DNS AAAA (IPv6) record
create_cname_record	Create a DNS CNAME record
create_host_record	Create a Host record (A + PTR combined), supports next-available-IP
create_ptr_record	Create a PTR (reverse DNS) record
create_mx_record	Create a mail exchange record
create_txt_record	Create a TXT record
create_srv_record	Create a SRV record
update_dns_record	Update any DNS record by reference
delete_dns_record	Delete any DNS record by reference

Network & IPAM

Tool	Description
get_networks	Search and list networks with utilization data
create_network	Create a network with optional DHCP member and options
delete_network	Delete a network
get_next_available_ip	Get next available IP address(es) from a network
search_ip_addresses	Search IPv4 address space — find used/unused IPs
get_network_details	Get network details including DHCP utilization stats

DHCP

Tool	Description
get_fixed_addresses	Search DHCP reservations by IP, MAC, or network
create_fixed_address	Create a DHCP fixed address (reservation)
delete_fixed_address	Delete a DHCP reservation
get_dhcp_leases	View active DHCP leases
get_dhcp_ranges	List DHCP scopes/ranges
create_dhcp_range	Create a DHCP range

DNS Zones

Tool	Description
get_zones	Search and list authoritative DNS zones
create_zone	Create a forward or reverse DNS zone
delete_zone	Delete a DNS zone

Grid & Infrastructure

Tool	Description
get_grid_info	Get grid configuration and status
get_members	List grid members and their service status
restart_services	Restart DNS/DHCP services (required after config changes)
get_object_by_ref	Retrieve any object by its WAPI reference
global_search	Search across all object types
get_network_views	List network views
get_dns_views	List DNS views
get_extensible_attribute_definitions	List custom extensible attribute definitions

Installation

git clone git@github.com:fredriksknese/mcp-infoblox.git
cd mcp-infoblox
npm install
npm run build

Configuration

The server is configured via environment variables:

Variable	Required	Default	Description
INFOBLOX_HOST	Yes	—	Infoblox server hostname or IP
INFOBLOX_USERNAME	Yes	—	WAPI username
INFOBLOX_PASSWORD	Yes	—	WAPI password
INFOBLOX_WAPI_VERSION	No	2.12	WAPI version
INFOBLOX_ALLOW_SELF_SIGNED	No	true	Accept self-signed SSL certificates

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "infoblox": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-infoblox/dist/index.js"],
      "env": {
        "INFOBLOX_HOST": "your-infoblox-server.example.com",
        "INFOBLOX_USERNAME": "admin",
        "INFOBLOX_PASSWORD": "your-password"
      }
    }
  }
}

Usage with Claude Code

Add to your Claude Code MCP settings:

claude mcp add infoblox -- node /absolute/path/to/mcp-infoblox/dist/index.js

Set the required environment variables before running, or configure them in your MCP settings.

Example Prompts

Once connected, you can ask your AI assistant things like:

• "Show me all A records in the example.com zone"
• "Create a host record for server01.example.com with the next available IP in 10.0.1.0/24"
• "What DHCP leases are active on the 192.168.1.0/24 network?"
• "Find all DNS records pointing to 10.0.0.5"
• "Get the next 5 available IPs from the 10.10.0.0/16 network"
• "Create a CNAME alias web.example.com pointing to lb.example.com"
• "Show me network utilization for all 10.x networks"
• "Restart DNS services on the grid"

Development

npm run dev      # Run with tsx (auto-reloads)
npm run build    # Compile TypeScript to dist/
npm start        # Run compiled output

Architecture

src/
├── index.ts              # Entry point — creates MCP server + STDIO transport
├── infoblox-client.ts    # HTTP client wrapping Infoblox WAPI
└── tools/
    ├── dns.ts            # DNS record CRUD (12 tools)
    ├── network.ts        # Network/IPAM management (6 tools)
    ├── dhcp.ts           # DHCP management (6 tools)
    ├── zone.ts           # DNS zone management (3 tools)
    └── grid.ts           # Grid, search, views, extensible attrs (8 tools)

Requirements

• Node.js 18+
• Infoblox NIOS with WAPI enabled (tested with WAPI v2.12+)

License

MIT