FoundryNet / Error codes / MQTT / Sparkplug B CONNACK 3
MQTT / Sparkplug B error code

CONNACK 3 (0x03): Connection Refused: server unavailable

The broker is reachable at the network level but declines to service the connection: it is starting up, shutting down, or over capacity.

Start free MQTT / Sparkplug B → canonical

Diagnosis

When you hit this


Resolution

How to fix it

  1. Retry with exponential backoff
    Unlike codes 1, 2, 4 and 5, this one is genuinely transient. Back off rather than reconnecting in a tight loop.
  2. Check the connection limit
    Broker connection caps are commonly hit after adding a fleet of devices that each open more than one connection.
  3. Confirm cluster health
    In a clustered broker, a node in the process of joining refuses connections while it syncs.

Normalization

What Forge does about it

This is a transport failure, so there is nothing for Forge to normalize: the reading never arrives. What Forge does is refuse to let the gap look like good data. The read-time dropout check flags a field that fell to zero and recovered as a communication glitch rather than a real measurement, and the stuck-sensor check fires when a value repeats for 20 consecutive readings, which is what a cached or last-known value looks like after a link drops. Forge does not retry or reconnect for you; that is your client's or your gateway's job.


Connect

Normalize MQTT / Sparkplug B telemetry

One MCP endpoint serves every protocol adapter. 2,086 curated mappings, 985 canonical fields defined.

# normalize telemetry from MQTT / Sparkplug B, one of 13 protocols Forge reads
claude mcp add --transport http forge https://mcp.foundrynet.io/mcp \
  --header 'Authorization: Bearer YOUR_FORGE_KEY'
✓ forge connected, 32 tools available

Related

Keep reading

Other MQTT / Sparkplug B codes: CONNACK 1 CONNACK 2 CONNACK 5 Sparkplug NDATA before NBIRTH Sparkplug seq out of order

Equipment that speaks MQTT / Sparkplug B: MiR (Mobile Industrial Robots) Chemical process Food & beverage process Pharma process (GMP) OTTO Motors Geek+ (Geekplus) Locus Robotics Omron AMR (LD/HD) Trumpf

MQTT / Sparkplug B protocol hub

Other protocols: Modbus OPC UA FANUC FOCAS EtherNet/IP PROFINET / S7 BACnet/IP J1939 (CAN) MTConnect ROS 2 (DDS) SNMP MAVLink HTTP / REST CSV ingest

All error codes · All OEMs · All protocols

Why does a cross-vendor canonical data model matter? The Machine Agent breaks it down weekly. Read it →
Get the thesis behind this infrastructure: The Machine Agent, weekly.