Materials
The materials you've bought: prices, purchase history and market checks.
costcrunch 0.1.0
cost materials list
List materials you've bought with their latest, median, min and max prices.
- Command line
cost materials list- MCP tool
materials_list- Python
cc.materials.list()
| Parameter | Type | Description |
|---|---|---|
search--search | string | Only materials whose name contains this. |
supplier_id--supplier-id | string | Only materials bought from this supplier id. |
limit--limit | integer | Max materials (1-200). Default: 25 |
offset--offset | integer | Skip this many (paging). Default: 0 |
cost materials find <query>
Find materials you've bought by meaning, not just exact words (semantic search).
Use this to go from a free-text description to material ids for `materials get` / `history`.
- Command line
cost materials find <query>- MCP tool
materials_find- Python
cc.materials.find()
| Parameter | Type | Description |
|---|---|---|
queryrequired | string | Describe the material, e.g. '2x4 pressure treated'. |
limit--limit | integer | Max results (1-50). Default: 10 |
cost materials get <material-id>
Get one material: its category and every supplier variation you've bought (SKU, average, min and max price, how often, last purchase).
- Command line
cost materials get <material-id>- MCP tool
materials_get- Python
cc.materials.get()
| Parameter | Type | Description |
|---|---|---|
material_idrequired | string | Material id. |
cost materials history <material-id>
Every time you bought a material: date, supplier, document, project, quantity and price, plus totals and price range across all of them.
- Command line
cost materials history <material-id>- MCP tool
materials_history- Python
cc.materials.history()
| Parameter | Type | Description |
|---|---|---|
material_idrequired | string | Material id. |
supplier_id--supplier-id | string | Only purchases from this supplier id. |
project_id--project-id | string | Only purchases for this project id. |
since--since | string | On or after (YYYY-MM-DD). |
until--until | string | On or before (YYYY-MM-DD). |
sort--sort | string | Sort by. One of: date, unit_price, total_priceDefault: "date" |
ascending--ascending | boolean | Oldest / cheapest first. Default: false |
limit--limit | integer | Max purchases (1-100). Default: 25 |
page_number--page-number | integer | Page (1-based). Default: 1 |
cost materials prices <material-id>
What this material should cost: your own price history (last, average, median, best), what other suppliers charge, and online listings CostCrunch found, with links.
- Command line
cost materials prices <material-id>- MCP tool
materials_prices- Python
cc.materials.prices()
| Parameter | Type | Description |
|---|---|---|
material_idrequired | string | Material id. |