# ThingsBoard MCP for AI Agents AI Agent Connect > ThingsBoard lets you talk to your IoT hardware using just plain English. Instead of digging through a complex dashboard to check sensor readings or toggle a switch, you can just ask your AI agent to do it for you. This Connector connects your AI client directly to your ThingsBoard instance, allowing you to pull telemetry, trigger remote commands, and monitor alarms in real-time. It turns your IoT infrastructure into a conversational interface. ## Overview - **Category:** iot-hardware - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_UBFK6iWx3s89gzkdjDu4NajRmw3hiTs6UjT809b1/ai-agent-connect - **Tags:** iot-platform, device-management, telemetry, rpc-commands, smart-infrastructure ## Description Managing a fleet of IoT devices usually means jumping between browser tabs, hunting for specific device IDs, and squinting at time-series graphs just to see if a sensor is behaving. It is a lot of manual friction when you are trying to debug a hardware issue or get a quick status update on a remote asset. This Connector changes that by letting your AI agent do the heavy lifting for you. You can ask your agent to find every device in a specific region that is reporting high temperatures or tell it to flip a switch on a specific gateway. Because Vinkius makes it easy to connect these types of tools, you can move from searching for data to acting on data instantly. Whether you are pulling the latest humidity levels from a warehouse or checking the status of an alarm, the information comes to you in a readable format. It handles the messy work of navigating the REST API so you can focus on the actual engineering problems. You get a direct line to your hardware without the UI overhead. ## Tools ### find_entities Search for specific devices or assets using complex filters. This helps you locate specific hardware in a large fleet. ### get_telemetry Read the latest sensor readings for a specific entity. Use this to get current status updates on your hardware. ### save_attributes Save metadata or configuration values for any entity. This is useful for updating device settings in bulk. ### send_oneway_rpc Send a command to a device that does not require a response. This works for simple triggers like turning on a light. ### send_twoway_rpc Send a command and wait for a confirmation from the remote device. This ensures your action was actually successful. ### save_telemetry Push new time-series data to the ThingsBoard platform. Use this to log data directly from your agent. ### find_alarms Query active alarms based on severity or status. This helps you quickly see what needs immediate attention. ## Prompt Examples **Prompt:** ``` Is the temperature in Warehouse B safe right now? ``` **Response:** ``` Checking Warehouse B... The current temperature is 22°C. This is within the safe operating range of 18°C to 25°C. ``` **Prompt:** ``` Turn off the cooling fan on unit 4. ``` **Response:** ``` Sending command... The cooling fan on unit 4 has been turned off successfully. ``` **Prompt:** ``` Are there any active alarms I should know about? ``` **Response:** ``` I found 3 active alarms: - **High Pressure** (Unit 2) - **Low Battery** (Gateway-X) - **Connection Lost** (Sensor-9) ``` ## Capabilities ### Fetch real-time sensor data Get the latest telemetry values from specific devices instantly. ### Trigger one-way commands Send commands to hardware components that do not require a response. ### Receive two-way responses Send a command and wait for a confirmation back from the remote device. ### Search for specific assets Use complex filters to find devices or entities across your fleet. ### Update device attributes Save and manage metadata or configuration values for any entity. ### Monitor active alarms Query and filter alarms by severity and status to stay informed. ### Log new telemetry data Push new time-series data to the platform directly from your agent. ## Use Cases ### Emergency Response A technician asks the agent to find all CRITICAL alarms and report the locations of the failing gateways. ### Remote Maintenance An engineer uses the agent to send a toggleSwitch command to a remote industrial valve to test its movement. ### Rapid Prototyping A developer asks the agent to pull the last 10 temperature readings to see if a new firmware update is working. ### Fleet Audit An analyst asks the agent to find all devices in the Warehouse-A group and list their current power status. ## Benefits - Stop digging through dashboards by using find_entities to locate specific assets instantly. - Get immediate hardware feedback by using send_twoway_rpc to confirm command execution. - Reduce manual data entry by using save_telemetry to push data directly from your agent. - Monitor system health faster with find_alarms to see only the critical issues that matter. - Update configuration across your fleet using save_attributes to change settings in bulk. - Simplify debugging by using get_telemetry to pull current sensor states into a chat window. ## How It Works The bottom line is you get a conversational interface for your entire IoT infrastructure. 1. Subscribe to this Connector and provide your ThingsBoard Host URL and API Key. 2. Connect your AI client to the Vinkius catalog to authorize the connection. 3. Ask your agent to perform tasks like showing current telemetry or triggering a device action. ## Frequently Asked Questions **Can the ThingsBoard MCP actually turn on hardware?** Yes, it can send remote commands to your devices. You can ask your agent to toggle switches, start motors, or any other action your hardware is programmed to handle. **How do I see my sensor data without opening the website?** Once connected, your agent can pull the latest telemetry for any device. You just ask for the status, and it shows you the numbers right in the chat. **Can it help me find specific devices in a big fleet?** Yes, it uses filters to search for entities. You can ask it to find devices by location, type, or any other attribute you have saved in ThingsBoard. **Will it alert me to problems automatically?** You can ask your agent to check for active alarms. It can filter by severity so you only see the issues that require immediate action. **Is this only for industrial use?** No, it works for any IoT setup on ThingsBoard, from smart home sensors to large-scale industrial monitoring. It is about the platform, not the specific hardware. **How do I connect it to my account?** You will need your ThingsBoard Host URL and an API key. Once you provide those to your agent, it can start managing your devices. **Can I check the latest sensor readings for a specific device?** Yes. Use the `get_telemetry` tool by providing the entity type and ID. The agent will return the most recent time-series data points recorded for that device. **Is it possible to trigger a physical action on a device, like turning on a light?** Absolutely. You can use `send_oneway_rpc` for simple commands or `send_twoway_rpc` if you need to wait for a confirmation response from the device hardware. **How do I find all devices that currently have active critical alarms?** You can use the `find_alarms` tool with a query body specifying the severity as 'CRITICAL' and status as 'ACTIVE_UNACK' or 'ACTIVE_ACK'.