Meta Pixel

Get Smart Meter Texas Data

experimental

Check on or fetch a Smart Meter Texas usage pull started with request_smt_data, by its requestId. Returns the status and, once complete, up to 12 months of grid import and solar export totals by month, peak demand, and download links for CSV, Aurora Solar, OpenSolar, and Solargraf files. For a Texas homeowner looking at their own meter's usage, or an installer working with a customer's.

Second half of the two-step Smart Meter Texas flow. `request_smt_data` starts the pull and usually returns the data within about 20 seconds; when it comes back `pending`, call this tool with the same `requestId` after `checkAfterSeconds`. - Monthly totals, averages, and peak demand are always included once the pull is complete. - Set `includeIntervals: true` for the raw 15-minute readings (the most recent 3,000, about a month). The download links always carry the full year. - `months` limits the returned data to the most recent N calendar months. Read-only: it never starts a new Smart Meter Texas request.

Endpoint

POST https://meterplan.com/api/v1/get-smt-data

MCP tool name: get_smt_data

Inputs

  • requestIdstringrequired

    The requestId returned by request_smt_data (a UUID). Use it to check on a pull that came back pending, or to fetch the data again later.

  • includeIntervalsboolean

    When true, also return the raw 15-minute readings (the most recent 3,000 at most, about 31 days). Leave false for monthly totals only; the CSV, Aurora, OpenSolar, and Solargraf download links always carry the full year.

  • monthsnumber

    Limit the returned monthly totals, averages, and intervals to the most recent N calendar months (1-12). Omit for all available data, up to 12 months.

Outputs

  • statusenum<needs_clarification | pending | complete | error>

    needs_clarification: the address matched more than one meter and nothing was started; ask the user which of candidates is theirs, then call request_smt_data with that esiId. pending: Smart Meter Texas is still working; call get_smt_data with requestId after checkAfterSeconds. complete: usage data is included. error: see errorMessage.

  • requestIdstring

    Identifier for this pull. Pass it to get_smt_data. Null only when status is needs_clarification.

  • reusedboolean

    True when this result comes from a pull for the same meter in the last 24 hours (or one already in progress) instead of a new Smart Meter Texas request.

  • stepstring

    Current processing step, in plain words.

  • checkAfterSecondsnumber

    Present when status is pending: wait about this long before calling get_smt_data.

  • esiIdstring

    ESI ID of the meter.

  • utilitystring

    Utility (TDU) that serves the meter, such as Oncor or CenterPoint, when known.

  • serviceAddressstring

    Service address on file for this pull, when known.

  • dataStartstring

    First reading, local Central Time (YYYY-MM-DDTHH:MM:00).

  • dataEndstring

    Last reading, local Central Time (YYYY-MM-DDTHH:MM:00).

  • readingCountnumber

    Number of 15-minute readings covered.

  • monthlyAggregatesarray<object>

    Per-month totals, oldest first.

  • avgMonthlyImportKwhnumber

    Average grid import per month, in kWh.

  • avgMonthlyExportKwhnumber

    Average grid export (solar sent back) per month, in kWh.

  • peakDemandKwnumber

    Highest 15-minute grid import across the data, in kW.

  • hasSolarExportsboolean

    True when the meter recorded any exports to the grid.

  • intervalsarray<object>

    Raw 15-minute readings, oldest first. Only when includeIntervals is true; capped at the most recent 3,000.

  • intervalsTruncatedboolean

    True when intervals were capped at 3,000. Use the download links for the full year.

  • exportsobject

    Download links for the full data in each format. Present when status is complete.

  • errorCodestring

    Machine-readable failure reason when status is error, such as smt_agreement_failed or no_data.

  • errorMessagestring

    What went wrong and what to do next, when status is error.

  • candidatesarray<object>

    Present when status is needs_clarification: the meters found at the given address. Show them to the user and let them choose; never pick one for them.

  • summarystring

    One-paragraph plain-language summary of the result.

Example prompts

  • “Check on the Smart Meter Texas pull I just started.”
  • “Get the 15-minute readings for that request.”
  • “Show me just the last 3 months of usage from that pull.”