# SmartCut

> Cloud-based cutlist optimization API for the cut-to-size industry. SmartCut optimises cutting patterns for sheet, linear and roll materials (guillotine, beam/panel-saw and true-shape nesting), returning cut diagrams, labels and machine files (PDF, DXF, SVG, PTX, Biesse). Also offers a hosted cut-to-size e-commerce platform and a WordPress plugin.

A clean markdown copy of any documentation page is available by appending `.md` to its URL. The entire documentation as a single file is at https://smartcut.dev/llms-full.txt. A hosted MCP server is available at https://api.smartcut.dev/mcp (optimisation) and https://api.smartcut.dev/ecommerce/mcp (store configuration).

## Products
- [SmartCut API](https://smartcut.dev/): optimization API overview, capabilities and integration model.
- [Cut-to-size e-commerce](https://smartcut.dev/ecommerce): hosted storefront for selling cut-to-size materials online (Stripe, stock, banding).
- [Algorithms](https://smartcut.dev/algorithms): the whole algorithm family — sheet, linear and roll materials; efficiency, guillotine, beam and true-shape nesting cut types; Fast and Max search depths; and which material/cut-type combinations the API accepts.

## Proof
- [Benchmarks](https://smartcut.dev/benchmarks.md): SmartCut Max benchmarked vs Biesse OptiPlanner on 2,000+ real jobs — 123 stock saved. Plus Magi-Cut, OptiCutter and CutList Optimizer comparisons, and how results are checked against the fewest stock each job could ever need.
- [Beam saw optimization](https://smartcut.dev/beam-saw): Fast and Max modes, benchmark data, saw-ready CNC output.
- [Saw support](https://smartcut.dev/saw-support): validated CNC file export for 13+ beam saw models across 8 vendors (Homag PTX, Biesse XML, Mayer .may, SCM, Schelling, Giben, Striebig, Jingwei).
- [Compare](https://smartcut.dev/compare): factual comparison of SmartCut vs Ardis and Magi-Cut.
- [Live WooCommerce demo store](https://store.smartcut.dev): a real WordPress + WooCommerce shop running the SmartCut cut-to-size plugin — server-rendered, browse it like a customer.

## Comparisons
- [Best cutlist optimizer — web tools compared](https://smartcut.dev/best-cutlist-optimizer): every web-based cutlist optimizer side by side — features, free tiers, pricing, machine files and benchmarks (vendor-published claims only, dated).

## Integrate
- [smartcut-api on GitHub](https://github.com/jgmedialtd/smartcut-api): the OpenAPI specification, runnable examples in curl, Node, Python and PHP, and the MCP configuration. There is no SDK by design — generate a client from the spec.

## Documentation
- [SmartCut API Documentation](https://smartcut.dev/docs.md): Cloud-based cutting-optimization platform: REST API, embeddable calculator, hosted e-commerce, WordPress plugin and embedded diagrams.
- [API Reference](https://smartcut.dev/docs/api.md): Run SmartCut cutting optimization from your own software over a REST API. Submit parts and stock, get back cutting patterns, diagrams and machine files.
- [Guide](https://smartcut.dev/docs/guide.md): Helpful definitions and ways of doing things
- [Result webhooks](https://smartcut.dev/docs/webhooks.md): Receive finished SmartCut results at your own URL instead of polling: registration, payload, signature verification and retry behaviour.
- [MCP server](https://smartcut.dev/docs/mcp.md): Run SmartCut cutting-pattern optimisations from Claude, Cursor or a custom agent over the Model Context Protocol, using your existing API key.
- [Updates](https://smartcut.dev/docs/updates): Latest updates and changes to the SmartCut API
- [E-commerce Integration Guide](https://smartcut.dev/docs/ecommerce.md): Analytics tracking, webhook events, and API reference for SmartCut e-commerce
- [E-commerce cut-list calculator](https://smartcut.dev/docs/ecommerce-checkout.md): Embedded JavaScript widget for cut-list calculation on e-commerce websites
- [Inventory API](https://smartcut.dev/docs/ecommerce-inventory.md): Manage your store's materials and stock over HTTPS: create and update product lines, adjust quantities atomically, and sync from an ERP.
- [Store config MCP](https://smartcut.dev/docs/ecommerce-mcp.md): Configure your SmartCut storefront from your own LLM client over MCP: materials, stock, pricing, extras and formulas.
- [Embedded Diagram](https://smartcut.dev/docs/embed.md): Embed a SmartCut cut list visualisation on your website using an iframe
- [WordPress Plugin](https://smartcut.dev/docs/wordpress-plugin.md): SmartCut WordPress WooCommerce plugin documentation
- [3D model analysis](https://smartcut.dev/docs/model-analysis.md): Upload a STEP, STL, OBJ, PLY or glTF model to the SmartCut API and get back a parts list you can submit straight to /v3/calculate, with advice on shaped parts, fittings and overlapping solids.

## API reference
- [API v3 reference](https://smartcut.dev/api-docs/v3): current OpenAPI reference (interactive).
- [API v2 reference](https://smartcut.dev/api-docs/v2)
- [API v1 reference](https://smartcut.dev/api-docs/v1)
- [Endpoint reference — inventory & orders](https://smartcut.dev/api-docs/ecommerce): OpenAPI reference for the hosted store's materials, stock and order-workflow endpoints (interactive). The narrative guide for these is /docs/ecommerce-inventory.

## OpenAPI specs
- [v3 spec (JSON)](https://smartcut.dev/openapi/v3.json)
- [ecommerce spec (JSON)](https://smartcut.dev/openapi/ecommerce.json)