Inventory & Warehouse MCP Server

Complete inventory and warehouse management for ADK-Rust Enterprise agents. Provides 38 MCP tools covering the full warehouse lifecycle — stock management, serialized tracking, RFID, QR codes, pick/pack/ship, wave planning, putaway, cycle counts, BOM, and space utilization. Zero configuration, no external dependencies.

Architecture

┌─────────────────────────────────────────────────────────────────────────┐
│                        mcp-inventory (38 tools)                          │
├────────────┬────────────┬────────────┬────────────┬─────────────────────┤
│  Catalog   │   Stock    │  Warehouse │ Serialized │   Identification    │
│  & BOM     │ Movements  │    Ops     │  Tracking  │   & Labeling        │
├────────────┼────────────┼────────────┼────────────┼─────────────────────┤
│ Items      │ Receive    │ Pick/Pack  │ Serial Reg │ Barcode (Code128)   │
│ Locations  │ Issue      │ Ship       │ Serial Move│ QR Codes            │
│ BOM        │ Transfer   │ Waves      │ Chain of   │ RFID (EPC)          │
│ Reorder    │ Adjust     │ Putaway    │ Custody    │ Batch Labels        │
│            │ Reserve    │ Cycle Count│ Location   │                     │
│            │            │ Space Mgmt │ Scan       │                     │
└────────────┴────────────┴────────────┴────────────┴─────────────────────┘

Key Principles

Full lifecycle — from goods receipt through storage, picking, packing, shipping, and returns.
Serialized tracking — individual unit tracking with full chain of custody history.
RFID-ready — register tags, process bulk reader scans, detect missing inventory.
QR code generation — encode serial, SKU, location, and shipment data for mobile scanning.
Space-aware — locations have capacity limits (units, weight, volume) with utilization reporting.
Wave planning — batch multiple pick orders for efficient warehouse operations.
Zero configuration — starts immediately with no external dependencies or API keys.

Tools (38)

Item Catalog

Tool	Description	Annotations
`item_upsert`	Add/update item (SKU, name, category, unit, reorder point, cost)	write
`item_list`	List all items in catalog	read-only

Locations & Space

Tool	Description	Annotations
`location_create`	Create warehouse/zone/aisle/rack/bin with capacity limits	write
`location_list`	List all locations	read-only
`space_utilization`	Capacity vs used report (units, weight, volume)	read-only

Stock Movements

Tool	Description	Annotations
`stock_receive`	Receive goods into location (from supplier, production, return)	write
`stock_issue`	Issue stock from location (sales, consumption, dispatch)	write
`stock_transfer`	Transfer between locations	write
`stock_adjust`	Adjust quantity (cycle count correction, damage write-off)	write (approval)
`stock_check`	Check stock level (total, reserved, available)	read-only
`reorder_alerts`	Items below reorder point with suggested order quantities	read-only
`movement_history`	Full movement audit trail for a SKU	read-only

Reservations

Tool	Description	Annotations
`stock_reserve`	Reserve stock for an order (prevents overselling)	write
`stock_release`	Release a reservation (cancel, expiry)	write

Bill of Materials

Tool	Description	Annotations
`bom_set`	Define components needed to build a parent item	write
`bom_check`	Check if enough components are available to build N units	read-only

Pick / Pack / Ship

Tool	Description	Annotations
`pick_create`	Create pick order with line items and location allocation	write
`pick_confirm`	Confirm picked quantities (detect shorts)	write
`pick_ship`	Mark as shipped (issues stock from locations)	write
`pick_list`	List all pick orders	read-only

Wave Planning

Tool	Description	Annotations
`wave_create`	Batch multiple pick orders into a wave	write
`wave_release`	Release wave (moves all picks to "picking" status)	write
`wave_complete`	Mark wave as completed	write
`wave_list`	List all waves	read-only

Putaway

Tool	Description	Annotations
`putaway_rule_create`	Define preferred location by item category	write
`putaway_suggest`	Suggest optimal bin for an item based on rules and space	read-only

Cycle Counts

Tool	Description	Annotations
`cycle_count_schedule`	Schedule a count for a location	write
`cycle_count_complete`	Submit actual counts, auto-detects discrepancies	write

Serialized Warehousing

Tool	Description	Annotations
`serial_register`	Register individual unit (serial number, lot, RFID, auto-QR)	write
`serial_move`	Move serialized item (full chain of custody)	write
`serial_lookup`	Look up serial — full history, location, status	read-only
`serial_scan_location`	List all serialized items at a location	read-only

RFID

Tool	Description	Annotations
`rfid_register`	Register RFID EPC tag, link to serial/SKU	write
`rfid_bulk_read`	Process reader scan — found, unknown, and missing detection	write
`rfid_lookup`	Look up tag by EPC	read-only

QR Codes & Labels

Tool	Description	Annotations
`qr_generate`	Generate QR payload for serial/SKU/location/shipment	write
`label_generate`	Generate barcode label (code128, EAN-13, QR, DataMatrix)	write
`label_batch`	Batch generate labels for multiple entities	write

Installation

From crates.io

cargo install mcp-inventory

Build from source

git clone https://github.com/zavora-ai/mcp-inventory
cd mcp-inventory
cargo build --release

Claude Desktop

{
  "mcpServers": {
    "inventory": { "command": "mcp-inventory" }
  }
}

Kiro

Add to .kiro/settings/mcp.json:

{
  "mcpServers": {
    "inventory": { "command": "mcp-inventory" }
  }
}

Cursor / Windsurf / Codex

{
  "mcpServers": {
    "inventory": { "command": "mcp-inventory" }
  }
}

Quick Start

1. Add items and locations

{"name": "item_upsert", "arguments": {"sku": "LAPTOP-PRO", "name": "Laptop Pro 16\"", "category": "electronics", "unit": "each", "reorder_point": 20, "reorder_qty": 100, "cost": 850, "currency": "USD"}}

{"name": "location_create", "arguments": {"name": "Warehouse A - Bin A3-07", "location_type": "bin", "capacity_units": 50, "capacity_weight_kg": 500}}

2. Receive stock

{"name": "stock_receive", "arguments": {"sku": "LAPTOP-PRO", "quantity": 30, "location_id": "loc_abc123", "actor": "receiving_clerk", "reference": "PO-2026-0142", "lot_number": "LOT-2026Q2"}}

3. Register serialized items with RFID

{"name": "serial_register", "arguments": {"serial_number": "SN-2026-00142", "sku": "LAPTOP-PRO", "location_id": "loc_abc123", "lot_number": "LOT-2026Q2", "rfid_tag": "E200001234567890"}}

Response:

{"status": "registered", "serial_number": "SN-2026-00142", "qr_code": "QR:SN=SN-2026-00142&SKU=LAPTOP-PRO&LOC=loc_abc123"}

4. Create pick order and wave

{"name": "pick_create", "arguments": {"order_reference": "ORD-8821", "items": [{"sku": "LAPTOP-PRO", "quantity": 2, "location_id": "loc_abc123"}], "default_location": "loc_abc123", "assigned_to": "picker_john"}}

{"name": "wave_create", "arguments": {"name": "Morning Wave", "pick_ids": ["pick_abc", "pick_def", "pick_ghi"], "priority": "high"}}

5. RFID bulk scan (detect missing inventory)

{"name": "rfid_bulk_read", "arguments": {"location_id": "loc_abc123", "epcs": ["E200001234567890", "E200009999999999"]}}

Response:

{"location_id": "loc_abc123", "scanned": 2, "found": 1, "unknown": 1, "missing": 0, "found_tags": [{"epc": "E200001234567890", "serial": "SN-2026-00142"}], "unknown_epcs": ["E200009999999999"], "missing_tags": []}

6. Track serialized item movement

{"name": "serial_move", "arguments": {"serial_number": "SN-2026-00142", "to_location": "STAGING-DOCK-1", "actor": "picker_john", "event_type": "picked", "reference": "ORD-8821"}}

7. Generate QR code for shipping label

{"name": "qr_generate", "arguments": {"entity_type": "serial", "entity_id": "SN-2026-00142", "extra_data": {"order": "ORD-8821", "destination": "Customer XYZ"}}}

Location Hierarchy

Warehouse A (warehouse)
├── Zone 1 - Electronics (zone)
│   ├── Aisle A (aisle)
│   │   ├── Rack A1 (rack)
│   │   │   ├── Bin A1-01 (bin) [capacity: 100 units, 200kg]
│   │   │   ├── Bin A1-02 (bin) [capacity: 100 units, 200kg]
│   │   │   └── ...
│   │   └── Rack A2 (rack)
│   └── Aisle B (aisle)
├── Zone 2 - Bulk Storage (zone)
├── Staging Area (staging)
└── Dock 1 (dock)

Serialized Item Lifecycle

serial_register → in_stock
    │
    ├── serial_move (event: "picked") → in_stock (at staging)
    │       │
    │       ├── serial_move (event: "shipped") → shipped
    │       │       │
    │       │       └── serial_move (event: "returned") → in_stock
    │       │
    │       └── serial_move (event: "scrapped") → scrapped
    │
    └── rfid_bulk_read → detect if missing from expected location

RFID Operations

Operation	What happens
`rfid_register`	Link EPC to serial/SKU, set initial location
`rfid_bulk_read`	Reader scans area → server compares against expected tags
Found	Tag is at expected location — update `last_read_at`
Unknown	Tag not in system — flag for investigation
Missing	Tag expected but not scanned — potential theft/misplacement

Barcode Formats

Format	Use Case	Example Value
`code128`	General purpose, high density	`SKU-LAPTOP-PRO`
`ean13`	Retail products	`5901234123457`
`qr`	Mobile scanning, rich data	`SN=X&SKU=Y&LOC=Z`
`datamatrix`	Small items, PCBs	Compact binary
`rfid_epc`	RFID tags (96-bit)	`E200001234567890`

Stock Movement Types

Type	From	To	Use Case
`receive`	—	Location	Goods receipt from supplier
`issue`	Location	—	Sales, consumption, dispatch
`transfer`	Location A	Location B	Internal movement
`adjust`	—	—	Cycle count correction, write-off

Configuration

Environment Variables

Variable	Required	Purpose
`RUST_LOG`	No	Log level (default: `info`)

No API keys or external services needed. All data is stored in-memory.

MCP Server Manifest

server_id = "mcp_inventory"
display_name = "Inventory"
version = "1.3.0"
domain = "inventory"
risk_level = "medium"
writes_allowed = "gated"
governance_gates = ["stock_movement_audit"]

Use Cases

Manufacturing

bom_set (define components for finished goods)
stock_receive (raw materials from supplier)
bom_check (can we build 100 units?)
stock_issue (consume components)
serial_register (each finished unit gets serial + RFID)

E-Commerce Fulfillment

stock_receive (bulk from supplier)
stock_reserve (customer places order)
pick_create → wave_create → wave_release (batch fulfillment)
pick_confirm → pick_ship (dispatch)
serial_move (event: "shipped", reference: order_id)

Pharmaceutical / Regulated

serial_register (each unit serialized per regulation)
rfid_register (cold chain monitoring)
serial_move (full chain of custody for audit)
cycle_count_schedule → cycle_count_complete (regulatory compliance)
qr_generate (patient-facing verification)

Retail / Multi-Store

location_create (store_1, store_2, warehouse)
stock_transfer (warehouse → store)
reorder_alerts (per-location thresholds)
rfid_bulk_read (daily inventory verification)
space_utilization (optimize shelf allocation)

Error Codes

Code	Meaning
`INSUFFICIENT_STOCK`	Not enough available stock for operation
`SERIAL_NOT_FOUND`	Serial number not registered
`RFID_NOT_FOUND`	EPC tag not in system
`PICK_NOT_FOUND`	Pick order ID doesn't exist
`WAVE_NOT_FOUND`	Wave ID doesn't exist
`BOM_NOT_FOUND`	No BOM defined for parent SKU
`RESERVATION_NOT_FOUND`	Reservation ID doesn't exist
`CYCLE_COUNT_NOT_FOUND`	Cycle count ID doesn't exist

Documentation

Document	Description
mcp-server.toml	ADK-Rust Enterprise registry manifest
CHANGELOG.md	Version history
Rust Docs	Generated API documentation

Contributing

Contributions welcome. Priority areas:

Persistent storage backend (PostgreSQL/SQLite)
Expiry date management (FEFO picking)
Multi-warehouse transfer orders
Inventory valuation (FIFO, LIFO, weighted average)
Integration with mcp-logistics for shipping
Barcode image generation (SVG/PNG)

Contributors

James Karanja Maina

License

Apache-2.0 — see LICENSE for details.

Part of the ADK-Rust Enterprise MCP server ecosystem.

Built with ❤️ by Zavora AI

Registry Compliance

This server implements the ADK MCP SDK contract:

HealthCheck — async health probe for registry monitoring
mcp-server.toml — manifest declaring tools, risk classes, and credentials
Structured tracing — RUST_LOG env-filter for observability
Audit trail — every stock movement logged with actor, timestamp, and reference

mcp-inventory 1.4.0