SDKs
Official CloudSignal SDKs for browser, Node.js, and React, plus the CLI for managing access control.
CloudSignal ships official SDKs as @cloudsignal/* packages on npm. Pick the package that matches what you're building. For non-Node clients, any standard MQTT 5 client works against the same broker.
MQTT clients
Connect to the broker, exchange tokens, publish and subscribe.
| Package | Stability | What it does |
|---|---|---|
@cloudsignal/mqtt-client (repo) | Stable | WebSocket MQTT client for browser and Node.js, with token authentication, automatic reconnection, and platform presets. The default starting point for most apps. |
@cloudsignal/agent | Beta | Agent-to-agent (A2A) messaging primitives over MQTT 5, with a draft protocol spec for inbox, state, and request/response. |
@cloudsignal/ai-transport | Beta | Vercel AI SDK transport over MQTT. Drop-in replacement for HTTP streaming with offline recovery and multi-device sync. |
@cloudsignal/mcp-over-mqtt | Beta | Model Context Protocol (MCP) over MQTT 5, with broker-enforced ACL per tool. |
Install:
npm install @cloudsignal/mqtt-clientConnect from JavaScript or TypeScript with the JavaScript quickstart.
React UI primitives
Drop-in components and hooks for collaborative UIs.
| Package | Stability | What it does |
|---|---|---|
@cloudsignal/collaborate (repo) | Beta | Cursors, presence, locking, typing indicators, reactions, and shared state for React apps. |
@cloudsignal/notifications (repo) | Beta | Real-time in-app notifications for React with toast display and history. |
@cloudsignal/pwa-sdk (repo) | Stable | Web push notifications, install prompts, device tracking, and offline queue for Progressive Web Apps. |
Install whichever you need:
npm install @cloudsignal/collaborate
npm install @cloudsignal/notifications
npm install @cloudsignal/pwa-sdkThe PWA SDK has its own setup guide covering manifest, service worker, and permission flows.
CLI
| Package | Stability | What it does |
|---|---|---|
@cloudsignal/cli | Beta | Manage MQTT access-control policies and identity claims from the terminal or CI. |
Install:
npm install -g @cloudsignal/cliNon-JavaScript languages
CloudSignal speaks standard MQTT 3.1.1 and MQTT 5. Any compliant client connects with a username, password, and TLS. There is no language-specific lock-in.
| Language | Recommended client |
|---|---|
| Python | paho-mqtt (sync) or aiomqtt (async) |
| Go | eclipse/paho.golang |
| Rust | rumqttc |
| Java / Kotlin | HiveMQ MQTT Client or Eclipse Paho Java |
| .NET | MQTTnet |
For these languages, exchange your auth provider token for MQTT credentials via the Token exchange API, then connect using the host and port from Connection parameters.
The @cloudsignal/* SDKs add token management, reconnection logic, and presets on top of MQTT. If you only need plain pub/sub, the standard MQTT clients above are enough.
Next steps
- Connect from JavaScript - Five-minute quickstart with
@cloudsignal/mqtt-client - Connection parameters - Hosts, ports, and TLS for any client
- Token exchange API - Trade an identity provider token for MQTT credentials