# Golioth MCP for AI Agents AI Agent Connect

> Golioth MCP lets you manage your IoT device fleet and LightDB states directly through your AI agent. Instead of jumping between the Golioth console and your IDE, you can list projects, register new hardware, and update real-time device configurations using plain English. It's the fastest way to orchestrate connected devices without manual API calls.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_wYHRxDIii2rfGW0NRhCGA52xXLzwPnzMTVaGj6Ve/ai-agent-connect
- **Tags:** iot-management, hardware-control, lightdb, device-fleet, embedded-systems

## Description

Connecting your IoT infrastructure to an AI agent changes how you handle hardware. Instead of keeping dozens of browser tabs open to check sensor readings or toggle LED states, you can just ask your agent to do it. You can see exactly what's happening across your entire fleet, from checking if a new device is online to updating the configuration of a thousand units at once. It takes the friction out of managing LightDB states, making it feel like you're talking directly to your hardware.

When you connect this Connector through the Vinkius catalog, your AI becomes a remote terminal for your IoT ecosystem. You don't have to worry about remembering specific endpoints or constructing complex JSON payloads for every update. Whether you're debugging a firmware issue or auditing your project structure, you get a direct line of communication to your devices. It's about moving away from manual dashboard clicking and toward a system where your AI handles the heavy lifting of device orchestration.

## Tools

### get_lightdb_state
Read the current real-time data or configuration for a specific device. Use this to check sensor values or current settings.

### list_devices
See all hardware units registered within a specific Golioth project. This helps you audit your active fleet quickly.

### list_projects
View all your existing Golioth projects to organize your infrastructure. It's the best way to see your high-level setup.

### register_device
Add a new piece of hardware to your project for immediate management. This lets you expand your fleet on the fly.

### remove_device
Delete a decommissioned unit from your project to keep your fleet clean. Use this to remove hardware no longer in use.

### set_lightdb_state
Update the configuration or sensor values for a device instantly. This is the primary way to control hardware behavior.

### create_project
Build a new project container to organize your IoT devices. Use this to segment different hardware types or environments.

## Prompt Examples

**Prompt:** 
```
List all my Golioth projects.
```

**Response:** 
```
I've found your projects: 

* **Smart-Home-Hub** (ID: proj_123)
* **Industrial-Sensors** (ID: proj_456)

Which one do you want to look at?
```

**Prompt:** 
```
Show me the devices in the Smart-Home-Hub project.
```

**Response:** 
```
In the **Smart-Home-Hub** project, I see 3 active devices:

* Living-Room-Temp
* Kitchen-Light
* Main-Gateway

Would you like to see the state for any of these?
```

**Prompt:** 
```
Set the power to 'on' for the Kitchen-Light.
```

**Response:** 
```
I've updated the LightDB state for **Kitchen-Light**. The 'power' path is now set to `{"on": true}`. The device should reflect this change immediately.
```

## Capabilities

### List all active projects
See every project you have organized in your Golioth account.

### Register new hardware
Add new devices to your project for immediate management and tracking.

### Update LightDB states
Change device configurations or sensor values in real-time via natural language.

### View device connectivity
Check which devices are online and active within your project.

### Create project structures
Build new project containers to organize different IoT use cases.

### Remove decommissioned hardware
Clean up your fleet by removing old or inactive devices from your projects.

## Use Cases

### Debugging a faulty sensor
An engineer asks the agent to check the status of a device and see if the LightDB state matches the expected firmware output using get_lightdb_state.

### Rapid fleet expansion
A manager asks the agent to register 50 new devices to a specific project to see them appear in the dashboard immediately using register_device.

### Configuration updates
A developer tells the agent to turn on all lights in a Home project by updating the power path in the LightDB state using set_lightdb_state.

### Fleet auditing
An admin asks for a list of all projects and the number of devices in each to plan for next month's hardware rollout using list_projects.

## Benefits

- Stop switching tabs by using list_projects and list_devices to see your entire fleet in one chat.
- Update hardware configs instantly with set_lightdb_state instead of manual console entries.
- Manage hardware lifecycle easily using register_device and remove_device to keep your project tidy.
- Get real-time sensor data with get_lightdb_state without writing custom scripts.
- Organize your infrastructure faster by using create_project to segment different IoT use cases.

## How It Works

The bottom line is you get a hands-on way to control your IoT fleet without leaving your chat interface.

1. Subscribe to the Golioth MCP and provide your Golioth API Key.
2. Connect your preferred AI client like Claude, Cursor, or Windsurf.
3. Ask your agent to perform actions like listing devices or updating states.

## Frequently Asked Questions

**What can I do with the Golioth MCP?**
You can use it to manage your IoT projects, register new hardware, and update device configurations using natural language. It acts as a bridge between your AI agent and your Golioth cloud.

**Can I use the Golioth MCP to manage my IoT devices?**
Yes. It allows you to list devices, remove old ones, and monitor your fleet status directly through your AI client.

**How does Golioth help with LightDB states?**
It lets you read and write real-time data for your devices. You can ask your agent to update specific paths like sensor thresholds or LED states without manual API calls.

**Can I register new hardware using the Golioth MCP?**
Yes, you can register new devices to your existing projects using the register_device tool. This helps you keep your fleet updated without leaving your workspace.

**Is the Golioth MCP good for IoT engineers?**
It's excellent for engineers who need to check device statuses and update configurations quickly while they are debugging firmware or working in their IDE.

**Can I see all my projects at once with Golioth?**
Yes, the Connector can retrieve a full list of your Golioth projects so you can navigate your infrastructure more easily.

**How do I update a device's status with Golioth MCP?**
Just tell your agent which device you want to change and what the new value should be. It will use the set_lightdb_state tool to apply the change immediately.

**Can Golioth MCP help me manage a large fleet of sensors?**
Yes, it's designed for fleet management. You can list all devices in a project to audit your hardware or update states across your connected devices.

**How can I read the current sensor data from a specific device?**
Use the `get_lightdb_state` tool by providing the Project ID, Device ID, and the specific path (e.g., 'sensor/temp'). The agent will return the current value stored in Golioth's LightDB.

**Can I register a new device to my project using the AI?**
Yes! Use the `register_device` action. You just need to provide the Project ID and a name for the new device. The agent will handle the registration and return the device details.

**Is it possible to update device configurations remotely?**
Absolutely. Use the `set_lightdb_state` tool to write JSON data to any path on the device. This is perfect for updating thresholds, toggling states, or sending commands to your hardware.