From c837024b5d510e17f993694db58829275599e9ac Mon Sep 17 00:00:00 2001
From: Ryan Malloy <ryan@supported.systems>
Date: Wed, 17 Sep 2025 06:47:26 -0600
Subject: [PATCH] Add llms.txt for AI model discovery and integration

- Concise technical overview for AI models and LLM systems
- Key features, installation, and integration examples
- MQTT tools reference and use cases
- Standard format for AI model consumption
- Ready for PyPI publication
---
 llms.txt | 54 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 54 insertions(+)
 create mode 100644 llms.txt

diff --git a/llms.txt b/llms.txt
new file mode 100644
index 0000000..bc04132
--- /dev/null
+++ b/llms.txt
@@ -0,0 +1,54 @@
+# mcmqtt - FastMCP MQTT Server
+
+mcmqtt is a FastMCP server that enables MQTT integration for MCP clients with embedded broker support and fractal agent orchestration.
+
+## Quick Start
+```bash
+uvx mcmqtt                    # Start STDIO server (default)
+uvx mcmqtt --transport http   # Start HTTP server
+```
+
+## MCP Integration
+```bash
+claude mcp add task-buzz -- uvx mcmqtt
+```
+
+## Core Features
+- Zero-configuration MQTT broker spawning
+- FastMCP native Model Context Protocol server
+- Real-time message publishing and subscribing  
+- Embedded broker management
+- Cross-platform compatibility (Linux, macOS, Windows)
+
+## MQTT Tools Available
+- mqtt_connect - Connect to MQTT brokers
+- mqtt_publish - Publish messages with QoS support
+- mqtt_subscribe - Subscribe to topics with wildcards
+- mqtt_get_messages - Retrieve received messages
+- mqtt_status - Get connection and statistics
+- mqtt_spawn_broker - Create embedded brokers instantly
+- mqtt_list_brokers - Manage multiple brokers
+
+## Architecture
+Clean modular design: CLI → Config → Logging → Server → MQTT → MCP → Broker → Middleware
+
+## Use Cases
+- AI agent coordination and swarm intelligence
+- IoT sensor data collection and processing
+- Microservice event streaming and coordination
+- Real-time gaming and live applications
+- DevOps infrastructure automation
+- Multi-model AI orchestration
+
+## Installation
+```bash
+uvx mcmqtt                    # Recommended: instant execution
+uv add mcmqtt                 # Or install with uv
+pip install mcmqtt            # Or use pip
+```
+
+## Repository
+https://git.supported.systems/MCP/mcmqtt
+
+## License
+MIT
\ No newline at end of file