# Inventory MCP: actual stdio client calls

The inventory fixture contains A001 with seven units and B002 with zero. The server exposes exactly one tool, inventory_lookup, over stdio. Its strict Zod input schema accepts one uppercase letter and three digits and rejects extra fields. A missing C003 produces status not_found and units null, making absence distinct from zero stock. Tool annotations describe the local read-only behavior; they are not a security boundary.

The official SDK client launched the compiled server as a separate Node process. Its actual JSON-RPC transcript includes initialize, notifications/initialized, tools/list, and seven tools/call requests. The negotiated protocol was 2025-11-25. The three required SKU calls returned their expected structured output. Numeric, lowercase and extra-property inputs returned isError responses. A repeated A001 read remained seven. All eight Node tests passed. The saved server stderr is empty.

TypeScript compilation passed. Exact dependencies are locked: @modelcontextprotocol/sdk 1.32.0, zod 4.6.5, typescript 5.9.3 and @types/node 20.19.29. Installation disabled lifecycle scripts. There were no production credentials or external service calls; package installation required registry access.

## Run the server and client

Extract source-and-evidence.zip into a new directory, then run:

```sh
npm ci --ignore-scripts --no-audit --no-fund
npm run build
npm test
```

The test client starts and stops its own server subprocess. An MCP host can instead launch `node dist/server.js` in this directory; stdout is reserved for MCP messages. Do not expect a browser HTTP endpoint from a stdio server.

The result demonstrates the local protocol interface, not deployment, authentication, rate limiting, production integration, MCP Inspector UI coverage, or a model's ability to choose the tool.

## Provenance

Pinned source: [anthropics/skills at 8a1541c4a3ffa5a20a5a91de0dcf3f0bab1d1ef4](https://github.com/anthropics/skills/blob/8a1541c4a3ffa5a20a5a91de0dcf3f0bab1d1ef4/skills/mcp-builder/SKILL.md). Exact source hashes and references are in sources.json.

Executed on 2026-10-04 by Codex in this conversation using Node.js 24.13.0 and Python 3.12.3 on Linux. The exact model version was not exposed. Original command timestamps and stream hashes are in commands.jsonl. These records do not establish independent human adoption, customer outcomes or a compatibility certification.
