Resolve a MAC address (or bare OUI prefix) to its IEEE-registered hardware vendor. Accepts any common format — FC:FB:FB:01:02:03, fc-fb-fb-01-02-03, fcfb.fb01.0203, fcfbfb, or a 9-hex MA-S prefix. Uses longest-prefix matching across the IEEE MA-L (24-bit), MA-M (28-bit) and MA-S (36-bit) registries so blocks IEEE has subdivided resolve to the actual manufacturer. Returns the vendor name, the matched OUI prefix and which registry it came from, plus decoded address bits: whether the address is multicast/group, locally administered, or a randomized (privacy) MAC — for which no vendor exists by design. Authoritative bundled IEEE data.
/api/net/mac-vendorPAYMENT-SIGNATURE.The mac vendor API is a pay-per-call net endpoint built for AI agents and autonomous software. Resolve a MAC address (or bare OUI prefix) to its IEEE-registered hardware vendor.
There is no signup and no API key. An agent (or any HTTP client) hits the endpoint, receives an x402 "402 Payment Required" challenge, signs a sub-cent USDC payment on Base or Solana, and retries — the data comes back on the paid request. That makes it a drop-in mac vendor data source for an agent tool-use loop, an MCP host, or a backend that needs net data on demand without onboarding to yet another vendor portal.
| Name | Type | Description |
|---|---|---|
macrequired | string | MAC address or OUI prefix, e.g. FC:FB:FB:01:02:03 or fcfbfb. min 1 chars · max 64 chars |
# 1. Probe with no auth → 402 envelope with PaymentRequirements curl -sS 'https://2s.io/api/net/mac-vendor?mac=example' # 2. Sign + retry with PAYMENT-SIGNATURE: curl -sS 'https://2s.io/api/net/mac-vendor?mac=example' \ -H 'PAYMENT-SIGNATURE: <base64-json-payload>' # Or use the canonical runner (handles probe → sign → retry): # EVM_PRIVATE_KEY=0x... node --env-file=.env.local \ # --experimental-strip-types scripts/x402-pay.ts \ # 'https://2s.io/api/net/mac-vendor?mac=example'
import { TwoS } from '@2sio/sdk'
const client = new TwoS({
privateKey: process.env.EVM_PRIVATE_KEY as `0x${string}`,
})
const result = await client.net.macVendor({
"mac": "example"
})
console.log('endpoint:', result.endpoint)
console.log('cost:', result.costUsd, 'USDC')
console.log('tx:', result.settlement?.txHash)
console.log('data:', result.data)import os
from twosio import TwoS
client = TwoS(private_key=os.environ["EVM_PRIVATE_KEY"])
result = client.net.mac_vendor(mac="example")
print("endpoint:", result.endpoint)
print("cost:", result.cost_usd, "USDC")
print("tx:", (result.settlement or {}).get("tx_hash"))
print("data:", result.data)// 1. Add @2sio/mcp to your MCP host config (Claude Desktop example below).
// EVM_PRIVATE_KEY funds x402 payments per call.
// claude_desktop_config.json
{
"mcpServers": {
"2sio": {
"command": "npx",
"args": ["-y", "@2sio/mcp"],
"env": { "EVM_PRIVATE_KEY": "0x..." }
}
}
}
// 2. Once the server is running, agents call this tool via standard MCP:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "net.mac-vendor",
"arguments": {
"mac": "example"
}
}
}| Field | Type | Description |
|---|---|---|
query | object | |
normalized | string | |
oui | string | |
registry | string | one of: MA-L | MA-M | MA-S |
vendor | string | |
found | boolean | |
isMulticast | boolean | |
isLocallyAdministered | boolean | |
isRandomized | boolean | |
source | object |
{
"query": {
"mac": "example"
},
"normalized": "example",
"oui": "example",
"registry": "MA-L",
"vendor": "example",
"found": false,
"isMulticast": false,
"isLocallyAdministered": false,
"isRandomized": false,
"source": {
"provider": "example",
"url": "example",
"license": "example"
}
}