networking_mac_address_generator
Generate random IEEE 802 MAC addresses for VMs and lab testing, or analyze and reformat existing ones. Supports unicast/multicast and locally/universally-administered bits.
Instructions
MAC Address Generator And Analyzer. Generate random IEEE 802 MAC addresses and analyze or reformat existing ones. The default generate operation returns count fresh random MACs (output varies every call — not idempotent) with selectable unicast/multicast and locally/universally-administered bits; other operations are deterministic: analyze decodes one MAC into OUI, NIC, cast/admin bits and best-effort vendor, format converts one MAC between notations, use_case emits a single MAC tuned for a scenario, and vendor_oui prefixes random NIC bytes onto a supplied OUI. Use this to fabricate MACs for VMs, lab testing, and network config; use osint_mac_vendor_lookup instead to resolve a real manufacturer from a known MAC. Runs locally via a JS logic bridge: read-only, non-destructive, contacts no external service, rate-limited to 60 requests/min for anonymous callers. Returns a success flag, the echoed operation, and an operation-specific result.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| operation | Yes | Which action to perform. Defaults to generate. | generate |
| count | No | generate only: how many random MACs to return. | |
| mac | No | analyze/format only: the MAC to process; 12 hex digits, separators (: - .) ignored. | |
| format | No | Output notation for generate and format operations. | colon |
| unicast | No | generate only: force the unicast (LSB of first octet = 0) bit. | |
| locallyAdministered | No | generate only: set the locally-administered bit on generated MACs. | |
| universallyAdministered | No | generate only: clear the locally-administered bit (ignored if locallyAdministered is true). | |
| useCase | No | use_case only: scenario preset selecting the admin/cast bits. | virtual_machine |
| oui | No | vendor_oui only: 6 hex-digit OUI prefix to prepend to random NIC bytes. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| success | No | True when the operation completed. | |
| operation | No | The operation that was executed. | |
| result | No | Operation-specific payload. generate -> array of { mac, formatted, analysis }; analyze -> an analysis object; format -> { input, output, allFormats }; use_case -> { mac, formatted, useCase, description, analysis }; vendor_oui -> the generated 12-hex-digit MAC string. | |
| error | No | Present only when success is false; the failure reason. |