# Mqtt Embedded Integration

> Use when integrating, porting, configuring, or debugging embedded MQTT clients, brokers, keepalive, QoS, TLS transport, reconnects, or publish-subscribe issues

- **Type:** Skill
- **Install:** `agentstack add skill-easyzoom-aix-skills-mqtt-embedded-integration`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [easyzoom](https://agentstack.voostack.com/s/easyzoom)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [easyzoom](https://github.com/easyzoom)
- **Source:** https://github.com/easyzoom/aix-skills/tree/main/skills/mqtt-embedded-integration
- **Website:** https://github.com/easyzoom/aix-skills

## Install

```sh
agentstack add skill-easyzoom-aix-skills-mqtt-embedded-integration
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# MQTT Embedded Integration

## Overview

Use this skill for MCU MQTT clients by separating network link, TCP/TLS transport, MQTT session state, topic design, QoS, keepalive, and reconnect policy. MQTT success requires more than one successful publish.

## When To Use

Use this skill when:

- The user wants MQTT on an MCU or embedded device.
- The task involves MQTT connect, publish, subscribe, keepalive, QoS, Last Will, retained messages, broker auth, TLS, reconnect, or offline buffering.
- The issue is connection drops, no messages, duplicate messages, memory growth, TLS failure, or reconnect storms.

Do not use this skill when basic IP connectivity is not working. Use `lwip-integration` or platform network debugging first.

## First Questions

Ask for:

- MQTT library/client and version.
- Network stack, RTOS, transport, and whether TLS is used.
- Broker address, port, auth method, and certificate model without asking for secrets.
- Client ID, topics, QoS levels, keepalive, and reconnect policy.
- Current logs, broker logs, packet capture, or error codes.
- RAM budget and maximum payload size.

## Integration Checklist

1. Prove network first.
   Confirm DNS/IP, TCP connect, and broker reachability before MQTT debugging.

1. Configure identity.
   Client ID must be unique and stable enough for the product.

1. Bound payloads and buffers.
   Topic length, payload size, QoS queues, and offline buffers must fit RAM.

1. Set keepalive and reconnect policy.
   Avoid reconnect storms; use backoff and clear session behavior intentionally.

1. Add TLS deliberately.
   Validate time, CA storage, certificate chain, SNI, and heap usage.

1. Verify broker behavior.
   Test subscribe, publish, QoS behavior, retained messages, and Last Will if used.

## Common Failures

- Two devices use the same client ID and kick each other off.
- TLS fails because device time is invalid.
- Keepalive too short for poor networks.
- QoS 1 duplicates are not handled idempotently.
- Offline queue grows without bounds.
- Topic wildcards subscribe to too much traffic for MCU RAM.

## Verification

Before claiming MQTT works:

- State client library, broker transport, TLS/auth mode, client ID policy, and keepalive.
- Confirm connect, subscribe, publish, disconnect, and reconnect behavior.
- Confirm max payload and buffer limits.
- Confirm TLS certificate/time handling if TLS is used.
- Confirm secrets were not logged or stored in examples.

## Example

User:

```text
MCU MQTT 能连上但过一会儿就掉线。
```

Agent:

1. Asks for client library, keepalive, network stack, broker logs, TLS state, and reconnect policy.
1. Checks ping/keepalive and duplicate client ID before changing payload logic.
1. Verifies reconnect with backoff and subscription restoration.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [easyzoom](https://github.com/easyzoom)
- **Source:** [easyzoom/aix-skills](https://github.com/easyzoom/aix-skills)
- **License:** MIT
- **Homepage:** https://github.com/easyzoom/aix-skills

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-easyzoom-aix-skills-mqtt-embedded-integration
- Seller: https://agentstack.voostack.com/s/easyzoom
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.