Sensorist MCP by usefulapi

Get the user and account details of the signed-in Sensorist login. With list=true, return every user in the account hierarchy. Sensorist API: GET /v1/users.

{
  "type": "object",
  "properties": {
    "list": {
      "description": "true = return an array of all users in your hierarchy instead of only your own user.",
      "type": "boolean"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the gateways (device inventory) of the account. Each gateway lists its sensors, and each sensor its data sources (the ids the measurement tool needs). By default only master gateways are returned. Sensorist API: GET /v1/gateways.

{
  "type": "object",
  "properties": {
    "serials": {
      "description": "Only gateways with these serial numbers.",
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Za-z0-9_-]{1,64}$"
      }
    },
    "from": {
      "description": "Only gateways added to the account after this date.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
    },
    "include_slaves": {
      "description": "true = also return slave gateways.",
      "type": "boolean"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Get sensor measurements for data sources of ONE gateway. type: latest (most recent values), min_max (minimum and maximum with dates), climate (ETCCDI climate days), range (grouped average, minimum and maximum) or raw (unfiltered, up to 5,000 per page; pass the reply's next value as offset to read on). The default period is the past week. Sensorist API: GET /v1/measurements.

{
  "type": "object",
  "properties": {
    "data_sources": {
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Za-z0-9_-]{1,64}$"
      },
      "description": "Data source ids, all from the same gateway (from sensorist_list_gateways)."
    },
    "type": {
      "type": "string",
      "enum": [
        "latest",
        "min_max",
        "climate",
        "range",
        "raw"
      ],
      "description": "Kind of measurement query."
    },
    "from": {
      "description": "Period start (UTC). Ignored for latest.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
    },
    "to": {
      "description": "Period end (UTC). Ignored for latest.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
    },
    "indices": {
      "description": "climate only: which indices to return (default all).",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "frost_days",
          "ice_days",
          "summer_days",
          "tropical_nights"
        ]
      }
    },
    "ticks": {
      "description": "range only: approximate number of values to return.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 10000
    },
    "interval": {
      "description": "range only: grouping interval in minutes.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "seq_from": {
      "description": "raw only: first sequence number to return.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "seq_to": {
      "description": "raw only: last sequence number to return.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "offset": {
      "description": "raw only: the next value from the previous reply.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "data_sources",
    "type"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the data source alarms set by the account and their current state, with the most recent log entries. Sensorist API: GET /v1/alarms.

{
  "type": "object",
  "properties": {
    "include_notes": {
      "description": "true = include the notes on each alarm.",
      "type": "boolean"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Get the alarm log history: when each alarm went into and out of alarm. By default the entries are in time order. format=pairs returns each in/out pair together; format=combined adds system notifications. Sensorist API: GET /v1/alarms/history.

{
  "type": "object",
  "properties": {
    "alarms": {
      "description": "Only these alarm ids (from sensorist_list_alarms).",
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Za-z0-9_-]{1,64}$"
      }
    },
    "from": {
      "description": "Period start (UTC).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
    },
    "to": {
      "description": "Period end (UTC).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?Z)?$"
    },
    "format": {
      "description": "pairs = in/out pairs; combined = with system notifications.",
      "type": "string",
      "enum": [
        "pairs",
        "combined"
      ]
    },
    "include_notes": {
      "description": "true = include the notes on each entry.",
      "type": "boolean"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}