Skip to content
Eden Engine

Safecast Device Readings (Radiation and Air Quality)

safecasttt/device-readings

Returns the latest record and short recent history of one Safecast device: location, place name, temperature, humidity, pressure, battery, radiation counts per minute and particulate values where the device measures them, plus up to five recent Geiger, particulate and location entries. Takes the device_id from the recent-devices tool (the digits of a note:dev: device). An unknown id is refused as VALIDATION. Safecast data as served by Eden Engine, not an official Safecast product.

activeper callv1

Price

$0.0026 per call

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $0.50.

Data source

Safecast

Radiation and air quality readings from Safecast (safecast.org), a citizen science project whose data is released to the public domain. No attribution is required; we credit Safecast as a courtesy. Served by Eden Engine; not an official Safecast product.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

Connect once and your AI can find and run this tool, and any other it needs.

agent
// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "safecasttt/device-readings" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "safecasttt/device-readings" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "safecasttt/device-readings", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "safecasttt/device-readings", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

ChargePrice
Per call
$0.0026
Updated
Oct 21, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "device_id"
  ],
  "properties": {
    "device_id": {
      "type": "string",
      "pattern": "^[0-9]{6,20}$",
      "description": "Digits of a Notecard device urn, for example '863740067254257' for note:dev:863740067254257. Get one from the recent-devices tool."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "required": [
    "current_values"
  ],
  "properties": {
    "opc_history": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      },
      "description": "Recent optical particle counter readings, newest first."
    },
    "pms_history": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      },
      "description": "Recent particulate sensor readings, newest first."
    },
    "pms2_history": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      },
      "description": "Recent readings of the second particulate sensor, newest first."
    },
    "current_values": {
      "type": "object",
      "required": [
        "device_urn",
        "when_captured"
      ],
      "properties": {
        "device": {
          "type": "integer",
          "description": "Numeric device number."
        },
        "loc_lat": {
          "type": "number",
          "description": "Latitude."
        },
        "loc_lon": {
          "type": "number",
          "description": "Longitude."
        },
        "env_temp": {
          "type": "number",
          "description": "Air temperature in degrees Celsius."
        },
        "lnd_712u": {
          "type": "number",
          "description": "Geiger tube count per minute, LND 712 (u)."
        },
        "loc_name": {
          "type": "string",
          "description": "Place name."
        },
        "device_id": {
          "type": "string",
          "description": "Digits of a note:dev: urn, for the device-readings tool; absent for other device families."
        },
        "device_sn": {
          "type": "string",
          "description": "Name the owner gave the device."
        },
        "env_humid": {
          "type": "number",
          "description": "Relative humidity in percent."
        },
        "env_press": {
          "type": "number",
          "description": "Air pressure in pascals."
        },
        "lnd_7318c": {
          "type": "number",
          "description": "Geiger tube count per minute, LND 7318 (c)."
        },
        "lnd_7318u": {
          "type": "number",
          "description": "Geiger tube count per minute, LND 7318 (u)."
        },
        "device_urn": {
          "type": "string",
          "description": "Device identifier, such as note:dev:863740067254257."
        },
        "lnd_7128ec": {
          "type": "number",
          "description": "Geiger tube count per minute, LND 7128 (ec)."
        },
        "opc_pm01_0": {
          "type": "number",
          "description": "PM1.0 from the optical particle counter."
        },
        "opc_pm02_5": {
          "type": "number",
          "description": "PM2.5 from the optical particle counter."
        },
        "opc_pm10_0": {
          "type": "number",
          "description": "PM10 from the optical particle counter."
        },
        "pms_pm01_0": {
          "type": "number",
          "description": "PM1.0 particulate concentration, micrograms per cubic metre."
        },
        "pms_pm02_5": {
          "type": "number",
          "description": "PM2.5 particulate concentration, micrograms per cubic metre."
        },
        "pms_pm10_0": {
          "type": "number",
          "description": "PM10 particulate concentration, micrograms per cubic metre."
        },
        "bat_voltage": {
          "type": "number",
          "description": "Battery voltage."
        },
        "loc_country": {
          "type": "string",
          "description": "ISO country code."
        },
        "device_class": {
          "type": "string",
          "description": "Device model family."
        },
        "when_captured": {
          "type": "string",
          "description": "Time of the reading, UTC, ISO 8601."
        }
      },
      "description": "The device's latest readings and state: location, environment, battery, radiation or particulate fields depending on the model.",
      "additionalProperties": true
    },
    "geiger_history": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      },
      "description": "Recent radiation counts, newest first; absent for devices with no Geiger tube."
    },
    "location_history": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      },
      "description": "Recent location fixes, newest first; absent when the device has none."
    }
  },
  "description": "A device's latest record and short recent histories for the sensors it has.",
  "additionalProperties": false
}