Get stock balance
Quantity and stock value of one item in one warehouse on a date.
MCP tool erpnext_read → get_stock_balance
read
Returns the quantity and stock value for one item in one warehouse, the same two figures as Quick Stock Balance in ERPNext (Stock > Tools). Without a date it returns today. It reads one item and one warehouse per call; to check a whole order, call it once per line.
Parameters
| Name | Type | Description |
|---|---|---|
| item_code string required | string | Item code from list_items. |
| warehouse string required | string | Warehouse name from your site. |
| date string | string | YYYY-MM-DD. Default: today. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "erpnext_read",
"arguments": {
"operation": "get_stock_balance",
"arguments": {
"item_code": "item code",
"warehouse": "warehouse"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"item_code": "WIDGET-100",
"warehouse": "Main - AC",
"date": "2026-10-14",
"quantity": 42,
"stock_value": 1260
},
"isError": false
}