stocktrim-mcp-server

# StockTrim MCP Server Model Context Protocol (MCP) server for [StockTrim Inventory Management](https://www.stocktrim.com/). This server provides AI assistants like Claude with tools to interact with your StockTrim inventory system, enabling natural language queries and operations for product management, customer data, and inventory control. ## Features - **Product Management**: Create, retrieve, update, and delete products with full lifecycle support - **Customer Operations**: Access and manage customer data - **Supplier Management**: Manage supplier information and relationships - **Inventory Control**: Set and update inventory levels across locations - **Purchase Orders**: Create and manage purchase orders with line items - **Sales Orders**: Track and manage sales orders - **Workflow Tools**: High-level business operations (forecast management, urgent orders) - **Safety Features**: User confirmation for destructive operations via MCP elicitation ([ADR 001](../docs/architecture/decisions/001-user-confirmation-pattern.md)) - **Service Layer Architecture**: Clean separation of business logic with dependency injection - **Type-Safe**: Full type hints with Pydantic validation for all operations ([ADR 002](../docs/architecture/decisions/002-tool-interface-pattern.md)) - **Production-Ready**: Built-in error handling, logging, and resilience - **FastMCP**: Built on FastMCP v3 for high-performance MCP implementation ## Installation ### Using UV (Recommended) ```bash # Install from workspace cd stocktrim-openapi-client uv sync --all-extras # Run server uvx --from . stocktrim-mcp-server ``` ### Using Pip ```bash pip install stocktrim-mcp-server stocktrim-mcp-server ``` ## Configuration The server requires StockTrim API credentials via environment variables: ### Environment Variables Create a `.env` file in your project root or set these in your environment: ```bash # Required STOCKTRIM_API_AUTH_ID=your_tenant_id_here STOCKTRIM_API_AUTH_SIGNATURE=yo…