# Microgram: soc-estimator

`station__algovigilance__microgram-soc-estimator` · native (always callable) · domain `algovigilance` · pv-relevance `pv-core`

State-of-Charge estimator using fused EKF + OCV + coulomb counting. Routes by available sensor data quality to select the best estimation method. Implements the BMS firmware logic from suit-power-bms spec 1.1.1.2.3.

## Agent metadata

- `idempotent`: true
- `read_only`: true
- `expected_latency_ms`: unknown (not yet contract-tested)
- `cost_tokens_estimate`: unknown

## Input schema

- `voltage_v` *number* (required) — Terminal voltage in volts
- `current_a` *number* — Instantaneous current in amps (positive = discharge)
- `temperature_c` *number* — Cell temperature in Celsius
- `time_delta_s` *number* — Time since last measurement in seconds
- `previous_soc` *number* — Previous SoC estimate (0.0-1.0)
- `cell_capacity_ah` *number* — Nominal cell capacity in Ah (default 5.0 for 21700)
- `chemistry` *string* — Cell chemistry — affects OCV curve shape
- `load_state` *string* — Current load regime

## Example call

```json
POST /api/mcp
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "station__algovigilance__microgram-soc-estimator",
    "arguments": {
      "voltage_v": 0
    }
  }
}
```

## Related

- [/tools](/tools) — all 7718 tools
- [/tools/algovigilance__microgram-soc-estimator](/tools/algovigilance__microgram-soc-estimator) — HTML page
- [/tools/algovigilance__microgram-soc-estimator/json](/tools/algovigilance__microgram-soc-estimator/json) — JSON form (agent-friendly)
- [/api/mcp](/api/mcp) — endpoint
- [/AGENTS.md](/AGENTS.md) — agent guide