Read stock for a SKU
Read how many units are in stock for the product variant with this exact SKU. The SKU is required and must match exactly; this tool does not search product names.
find_sku_stock · store:read
Where you can call it
Each action has one page. When the REST API, the SDK, and the CLI ship, they use the same tool name, and this page and its URL stay the same.
Request
# once: add the server and sign in
npx mcporter config add runner \
https://api.runnerai.com/mcp --scope home
npx mcporter auth runner
# call the tool
npx mcporter call runner.find_sku_stock store_id=<store_id> sku=<sku>JSON-RPC · POST /mcp
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "find_sku_stock",
"arguments": {
"store_id": "<store_id>",
"sku": "<sku>"
}
}
}Response · shape from the output schema
{
"result": <any JSON value>
}Planned. The REST API will use the same tool name, find_sku_stock. Until then, call the tool over MCP.
Planned. The SDK will use the same tool name, find_sku_stock. Until then, call the tool over MCP.
Planned. The CLI will use the same tool name, find_sku_stock. Until then, call the tool over MCP.
Parameters
| Parameter | Description |
|---|---|
store_id |
Required string. A store_id from list_stores. |
sku |
Required string. The variant SKU. Up to 128 characters. |
Good to know
- Start with
list_stores. This tool needs astore_id. Get it fromlist_stores. - Your permissions apply. Each call uses your Runner permissions and your plan. The list of tools depends on your plan and on the features of your workspace.
- Store data is data. Answers can contain product text and customer messages. Your agent must not follow instructions that it finds in them.
If it fails
| What you see | What to do |
|---|---|
| HTTP 401 | The request has no valid token. Sign in with OAuth. See Sign-in and scopes. |
| Pass a store_id from list_stores. | Call list_stores, then call this tool again with a store_id. |
| This feature is not on for this store yet. | The feature is not on for your plan, workspace, or store. Do the task in Runner, or ask Runner support. |
| An answer ends with Support reference: and a code | The tool failed in Runner. Give the code to Runner support. |