# Cloud Studio Gear

> Cloud Studio Gear is an MCP server for cloud and infrastructure. Read-only MCP access to Cloud Studio Gear IoT sites, devices, readings and alarms. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** API, CLI
- **Website:** https://cloudstudioiot.com
- **Repository:** https://github.com/cloudstudioiot/gear-mcp
- **MCP Registry name:** io.github.CloudStudioIoT/gear-mcp
- **Categories:** [cloud and infrastructure](https://ai-powered.com/categories/cloud-and-infrastructure), [analytics and data](https://ai-powered.com/categories/analytics-and-data)
- **Listing updated:** 2026-11-18

## About

This server connects an assistant to an existing Cloud Studio Gear IoT instance. It can list sites, find a device by name, address or serial, read current values with units and battery, pull history between two dates, and list open or closed alarms.

Access is bounded by the Gear user whose token you supply: every answer is filtered by that user's permissions, so a user who sees one client gives an assistant that sees one client. All six tools are marked read-only. History returns up to 5,000 points with min, max and average.

You need a Gear URL, an access token and an application with read permissions for accounts, facilities, alarms, devices and endpoints. Node.js 20 or newer is required, and the server is version 0.1.0.

## Features

- **Site and device listing:** Lists sites, and devices with offline, silent or alarmed ones filterable.
- **Live readings:** Current values with units, battery and last data time.
- **Endpoint history:** Points plus min, max and average between two dates.
- **Alarm lookup:** Open, closed or all alarms by client, site, device or endpoint.
- **Device search:** Find by name, address or serial.
- **Permission-scoped:** Answers follow the access token's user.

## Good for

- Ask which devices are offline at a site
- Check a freezer's temperature trend
- List open alarms for a client
- Find a sensor by its serial number

## Install

### Claude Code (Terminal)

```sh
claude mcp add gear-mcp --env GEAR_URL='<GEAR_URL>' --env GEAR_TOKEN='<GEAR_TOKEN>' -- npx -y @cloudstudioiot/gear-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "gear-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@cloudstudioiot/gear-mcp"
      ],
      "env": {
        "GEAR_URL": "<GEAR_URL>",
        "GEAR_TOKEN": "<GEAR_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "gear-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@cloudstudioiot/gear-mcp"
      ],
      "env": {
        "GEAR_URL": "<GEAR_URL>",
        "GEAR_TOKEN": "<GEAR_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "gear-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cloudstudioiot/gear-mcp"
      ],
      "env": {
        "GEAR_URL": "<GEAR_URL>",
        "GEAR_TOKEN": "<GEAR_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "gear-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@cloudstudioiot/gear-mcp"
      ],
      "env": {
        "GEAR_URL": "<GEAR_URL>",
        "GEAR_TOKEN": "<GEAR_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "gear-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@cloudstudioiot/gear-mcp"
      ],
      "env": {
        "GEAR_URL": "<GEAR_URL>",
        "GEAR_TOKEN": "<GEAR_TOKEN>"
      }
    }
  }
}
```

## Tools

- `list_facilities`: Lists the sites you have.
- `list_devices`: Lists devices in a site, filterable to problems.
- `get_device`: Current readings, battery, open alarms and last data time for a device.
- `get_endpoint_history`: History of an endpoint between two dates with min, max and average.
- `list_alarms`: Open, closed or all alarms for a client, site, device or endpoint.
- `find_devices`: Finds devices by name, address or serial.

## FAQ

### Can it change anything?

No. All six tools are read-only.

### What do I need to connect?

`GEAR_URL` and `GEAR_TOKEN`, or app token with email and password.

### Does it see all my clients?

Only what the token's user can see.

### How do I add Cloud Studio Gear to Claude Code?

Run this command in your terminal: claude mcp add gear-mcp --env GEAR_URL='<GEAR_URL>' --env GEAR_TOKEN='<GEAR_TOKEN>' -- npx -y @cloudstudioiot/gear-mcp

### What are the best alternatives to Cloud Studio Gear?

The closest alternatives to Cloud Studio Gear are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, mcp, dashboard-icons and Tapetide - Indian Stock Market MCP.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [mcp](https://ai-powered.com/mcp/mcp-mwfu4c84): mcp is an open-source MCP server for cloud and infrastructure.
- [dashboard-icons](https://ai-powered.com/mcp/dashboard-icons): dashboard-icons is an open-source MCP server for analytics and data.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [DataArcus for Power BI](https://ai-powered.com/mcp/dataarcus-for-power-bi): DataArcus for Power BI is a free MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/cloud-studio-gear
