Skip to main content
Glama
Ricoledan

korral-storelink-mcp

by Ricoledan

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
LOG_LEVELNoLogging level for the server.
ALLOW_WRITESNoIf set to true, permits write operations (korral_raise_replenishment_order). Defaults to false.
MAX_ORDER_UNITSNoHard ceiling on a single replenishment order, enforced independently of confirm.
STORELINK_KEYRINGNoJSON object mapping store_id to X-Korral-Store-Key. Alternative to STORELINK_KEYRING_FILE.
UPSTREAM_BASE_URLNoBase URL of the StoreLink API. When unset, the bundled mock upstream is used.
DEFAULT_LOOKBACK_DAYSNoDefault POS lookback window for korral_check_stock_risk (max 28).
STORELINK_KEYRING_FILENoPath to a file containing the same JSON keyring as STORELINK_KEYRING. Preferred in production.

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
korral_list_authorized_storesA

List the Korral stores this deployment is authorized to query, each with local time and closing time. Call this first to learn which store_id(s) are available — every other tool rejects a store_id not in this list. If exactly one store is authorized, store_id is optional on every other tool and defaults to it.

korral_check_stock_riskA

Assess whether a SKU at a store will run out before closing today, and whether a replenishment order would arrive in time. Combines current on-hand, recent sales velocity, and supplier lead time into one deterministic projection with an explicit confidence level and any data-quality caveats — the evidence used is included so the projection can be checked without another call. Use korral_list_recent_sales if you need the individual transactions behind the velocity figure (e.g. to check whether a single bulk sale skewed it).

korral_list_recent_salesA

List individual POS transactions for a SKU at a store, most recent first. Use this to see whether a sales velocity figure from korral_check_stock_risk was driven by many small baskets or a single large one (e.g. a catering order), or as the audit trail when a projection needs to be double-checked against what actually sold.

korral_get_order_statusA

Look up the status of a replenishment order previously raised with korral_raise_replenishment_order, by its order_id. Use this to follow up on an order from an earlier session, or to check upstream state after a write call returned WRITE_OUTCOME_UNKNOWN before deciding whether to resubmit.

korral_raise_replenishment_orderA

Raise a replenishment order for a SKU at a store. Defaults to a dry run: the response is a preview containing the exact order plus the on-hand, sales velocity, and stockout projection that justify it, a duplicate-order warning, and a quantity-sanity check — enough for a human to approve or reject without another tool call. Set confirm=true to execute, which also requires the deployment to have ALLOW_WRITES enabled. confirm=true reflects this agent's own judgment, not a recorded human approval — treat it accordingly.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Ricoledan/korral-storelink-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server