Skip to content
MCP server

Cloud Studio Gear

Read-only MCP access to Cloud Studio Gear IoT sites, devices, readings and alarms

Runs locallyStatus and history
Install
Platforms
API, CLI
Runs
Locally
Version
0.1.0
Listing updated
today

Similar MCP servers

About Cloud Studio Gear

Cloud Studio Gear is an MCP server for cloud and infrastructure. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • GEAR_URLURL of your Gear instance, e.g. https://gear.cloud.studioRequired
  • GEAR_TOKENGear access token of the user the assistant acts asRequired

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Pricing unknown

Gear plans are listed without prices

Prices change. Check cloudstudioiot.com before you buy.

Cloud Studio Gear 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.

How AIPoweredBot checks servers