Reference
Every operation is the same in all three places: a command for the cost CLI, a tool for AI assistants over MCP, and a method in Python. Parameters are the same too.
Generated from costcrunch 0.1.0. All operations are read-only.
Search
Search everything at once.
Documents
Invoices, quotes, credits, statements and other documents.
cost documents listList your documents, newest upload first.cost documents get <document-id>Get one document: header fields (supplier, dates, totals, charges, terms) and its line items.cost documents lines <document-id>List a document's line items with the material each one matched and its price check.cost documents search <query>Search documents by file name, supplier, project address or document number.cost documents countsHow many invoices are in each review status (new, needs_attention, approved, ...).
Suppliers
The suppliers you buy from and what you buy from each.
cost suppliers listList your suppliers with total spend and first/last purchase dates, biggest spend first.cost suppliers get <supplier-id>Get one supplier: spend (all time and last 30/60/90 days), branches/addresses and sales rep.cost suppliers materials <supplier-id>What you buy from a supplier: each material with its latest, average, min and max price.
Projects
Jobs / ship-to addresses and what each one has cost.
Materials
The materials you've bought: prices, purchase history and market checks.
cost materials listList materials you've bought with their latest, median, min and max prices.cost materials find <query>Find materials you've bought by meaning, not just exact words (semantic search).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).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.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.
Spend
Where the money goes: by month and by category.
Account
Who you're signed in as and which companies you can see.