# Sensorist MCP by usefulapi

> Sensorist MCP by usefulapi is a freemium MCP server for energy and smart home. Read-only MCP connector to Sensorist gateways, sensor readings and alarm history. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web, vscode
- **Website:** https://usefulapi.io/sensorist/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/sensorist
- **MCP Registry name:** io.usefulapi/sensorist
- **Categories:** energy and smart home
- **Listing updated:** 2026-11-18

## About

The README describes it as a hosted MCP endpoint that lets an AI client read data from a Sensorist account: gateway inventory, sensor measurements, alarm state and alarm history. Nothing is installed locally; you add the endpoint URL to a client and sign in with your Sensorist login through OAuth.

The five data tools are marked read-only and cover latest values, min/max readings, climate-day and range summaries, raw readings with paging, and the alarm log in time order or as in/out pairs. Four further tools handle usage metering, plan upgrades, subscription cancellation and feature requests.

It suits people who already monitor cellar, cold-storage or facility sensors in Sensorist and want to query them in Claude, ChatGPT, Cursor or VS Code. usefulapi operates it as an independent service, not an official Sensorist product.

## Features

- **Gateway and sensor listing:** Lists gateways with their sensors and the data source identifiers needed for measurement queries.
- **Measurement queries:** Returns latest values, min/max with dates, climate days, grouped ranges or raw readings for one gateway.
- **Alarm status and history:** Shows current alarm states and a log of when alarms entered and left alarm.
- **OAuth sign-in:** Clients authenticate with the Sensorist login page, so no API keys go into config files.
- **Usage meter:** A status tool reports calls used against the monthly limit of the current plan.

## Good for

- Ask which sensors exceeded a temperature threshold in the last day
- Review the alarm history of a cellar or cold-storage gateway for a month
- Check the latest humidity reading on every gateway
- Pull min and max readings for a facility report

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http sensorist https://sensorist.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://sensorist.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "sensorist": {
      "url": "https://sensorist.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "sensorist": {
      "type": "http",
      "url": "https://sensorist.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "sensorist": {
      "serverUrl": "https://sensorist.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "sensorist": {
      "type": "http",
      "url": "https://sensorist.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `sensorist_get_user`: Get the user and account details of the signed-in Sensorist login.
- `sensorist_list_gateways`: List the gateways (device inventory) of the account with their sensors and data sources.
- `sensorist_get_measurements`: Get sensor measurements for data sources of one gateway (latest, min_max, climate, range or raw).
- `sensorist_list_alarms`: List the data source alarms set by the account and their current state.
- `sensorist_list_alarm_history`: Get the alarm log history of when alarms went into and out of alarm.
- `sensorist_usage_status`: Report current usage, plan and remaining calls for the caller.
- `sensorist_request_feature`: Send a request to usefulapi for a feature the Sensorist tools cannot yet do.
- `sensorist_upgrade`: Get a paid Pro or Pro+ plan for Sensorist, or change Pro to Pro+.
- `sensorist_cancel_subscription`: Cancel the Pro subscription at the end of the paid period.

## FAQ

### What can I do with Sensorist in Claude or ChatGPT?

The website lists reading the latest and extreme values of a gateway, reviewing alarm history and checking users in the account.

### Do I put a Sensorist API key in the client config?

No. The README and site say to add only the URL. The server signs you in with OAuth using your Sensorist e-mail and password on the login page.

### What does it cost?

The Free plan includes 50 tool calls a month. Pro is $9 per month or $90 per year with 10,000 calls, and Pro+ is $39 per month or $390 per year with 100,000 calls.

### Can the AI change my Sensorist data?

The website states that all 5 Sensorist data tools are read-only.

### Is Sensorist MCP by usefulapi free?

Sensorist MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Sensorist MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http sensorist https://sensorist.usefulapi.io/mcp

### What are the best alternatives to Sensorist MCP by usefulapi?

The closest alternatives to Sensorist MCP by usefulapi are myIO, THRIVE Fleet Intelligence, Spark Pack, ElectricityFinder and (iS)NEPI - National Energy Performance Index.

## Where this comes from

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

## Alternatives

- [myIO](https://ai-powered.com/mcp/myio): myIO is an open-source MCP server for smart home.
- [THRIVE Fleet Intelligence](https://ai-powered.com/mcp/thrive-fleet-intelligence): THRIVE Fleet Intelligence is a free MCP server for energy and smart home.
- [Spark Pack](https://ai-powered.com/mcp/spark-pack): Spark Pack is a free MCP server for home services.
- [ElectricityFinder](https://ai-powered.com/mcp/electricityfinder): ElectricityFinder is a freemium MCP server for energy and smart home.
- [(iS)NEPI - National Energy Performance Index](https://ai-powered.com/mcp/is-nepi-national-energy-performance-index): (iS)NEPI - National Energy Performance Index is a paid MCP server for energy and smart home.
- [Barrio Grid](https://ai-powered.com/mcp/barrio-grid): Barrio Grid is a freemium MCP server for energy and smart home.
- [AgentDataAPI](https://ai-powered.com/mcp/agentdataapi): AgentDataAPI is a freemium MCP server for analytics and data.
- [StationSignals](https://ai-powered.com/mcp/stationsignals): StationSignals is a freemium MCP server for smart home.

---
Source: https://ai-powered.com/mcp/sensorist-mcp-by-usefulapi
