README.md
Manage DNS, DHCP, and IPAM through the Infoblox WAPI REST API
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)
├── ne
Tools (8)
search_dns_recordsSearch for A, AAAA, CNAME, Host, PTR, MX, TXT, SRV records with regex supportget_all_records_in_zoneList all DNS records in a specific zonecreate_a_recordCreate a DNS A recordcreate_host_recordCreate a Host record (A + PTR combined), supports next-available-IPget_next_available_ipGet next available IP address(es) from a networkcreate_fixed_addressCreate a DHCP fixed address (reservation)get_grid_infoGet grid configuration and statusrestart_servicesRestart DNS/DHCP services (required after config changes)Environment Variables
INFOBLOX_HOSTrequiredInfoblox server hostname or IPINFOBLOX_USERNAMErequiredWAPI usernameINFOBLOX_PASSWORDrequiredWAPI passwordINFOBLOX_WAPI_VERSIONWAPI versionINFOBLOX_ALLOW_SELF_SIGNEDAccept self-signed SSL certificatesConfiguration
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"}}}}Try it
→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?
→Get the next 5 available IPs from the 10.10.0.0/16 network
→Restart DNS services on the grid