@cloudsignal/mqtt-client

The underlying MQTT 5 client used by @cloudsignal/agent and @cloudsignal/mcp-over-mqtt. Most users do not need to import this package directly. The higher-level SDKs pull it in as a transitive dependency and expose the bits an agent or tool server actually needs.

Import it directly if you are wiring custom behavior on top of MQTT 5: publishing your own retained discovery cards, writing a different agent profile, or interacting with non-MQTT.Agent topics on the same broker.

Status

v2.2.x. Published on npm. MIT licensed.

Install

npm install @cloudsignal/mqtt-client

API surface

@cloudsignal/mqtt-client is the MQTT 5 client wrapper used by both higher-level SDKs. The full API is documented alongside each release in the package README; typedoc is generated alongside each release.

When you need it directly

Most apps should reach for @cloudsignal/agent or @cloudsignal/mcp-over-mqtt first. Use this package directly when you need:

• Raw MQTT 5 publish / subscribe with full access to packet properties.
• A custom presence or discovery shape that the A2A / MCP profiles do not cover.
• An MQTT 5 client outside the agent context (telemetry, logs, app traffic on the same broker).