# Mc Inventory

> Observe inventory contents and equipped items - epistemic, read-only. Returns inventory slots and equipped items

- Skill: `bdambrosio/mc-inventory` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add bdambrosio/mc-inventory`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bdambrosio/mc-inventory/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: bdambrosio (https://skillmd.com/u/bdambrosio)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/bdambrosio/mc-inventory

---


# Minecraft Inventory Tool

Observes inventory contents and equipped items. Read-only epistemic tool for checking current inventory state.

## Purpose

Inventory inspection for planning and decision-making. Returns both human-readable inventory text and machine-readable structured data including all slots and equipped items.

## Input

- `value`: Ignored

## Output

Returns uniform_return format with:
- `value`: Multi-line inventory text (human-readable)
- `data`: Structured inventory dict (machine-readable). Key fields:
  - `success`: Boolean
  - `slots`: Array of `{slot: int, item: string, count: int}`
  - `equipped`: `{hand: string, offhand: string}`

## Behavior & Performance

- Read-only: Does not modify inventory
- Fast status check
- Returns complete inventory state including empty slots

## Guidelines

- Use before planning item operations (equip, drop, craft)
- Check `equipped.hand` and `equipped.offhand` for currently held items
- Empty slots have `item: null` or empty string

## Usage Examples

Check inventory:
```json
{"type":"mc-inventory","out":"$inv"}
```