About this project

This repository provides a multi-language client ecosystem for the Katana Manufacturing ERP API, including Python and TypeScript clients plus an alpha Model Context Protocol (MCP) server. All clients are generated from an OpenAPI 3.1.0 specification and feature automatic retries, rate limit handling, and smart pagination. The Python client supports both sync and async operations with full Pydantic type safety, while the TypeScript client is async-only with full type safety and browser support. The MCP server wraps a curated subset of high-level tools (search, modify, fulfill, verify) and includes preview/apply pairs for write operations, enabling integration with AI assistants like Claude and Cursor. Configuration is flexible via environment variables, .env files, or direct parameters. The project is structured as a monorepo with shared documentation, architecture decision records, and a unified build system using uv. Development includes pre-commit hooks, conventional commits for automated releases, and comprehensive testing.