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. 16,908 curated mappings, 366 canonical fields.

# normalize telemetry from MQTT / Sparkplug B — and 13 other protocols
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

Industrial AI fails at the data layer. The Machine Agent explains why, weekly. Read it →
Get the thesis behind this infrastructure — The Machine Agent, weekly.