Tool Reference: Packages
MCP tools to create packages, add calcs, and compile a combined PDF.
A calc package bundles several calculations into a single, ordered PDF — with a cover page, table of contents, and consistent page numbering. The package tools let Claude assemble and compile one for you, and the result lands in the project's Files just as if you'd built it in the web app. See Packages for the full concept.
Package tools#
| Tool | What it does | Key arguments |
|---|---|---|
list_project_packages | Lists packages in a project | project_id |
get_package | Returns a package's full details, including ordered items | package_id |
create_package | Creates a new empty package in a project | project_id, title |
add_calc_to_package | Appends a calculation to a package | package_id, calc_id, optional title_override |
compile_package | Compiles the package PDF and files it on the project | package_id |
Building a package#
A typical flow:
- Create the package with
create_package(give it atitle, e.g. "Framing Calculations"). - Add calcs with
add_calc_to_package. Each call appends one calc to the end. The calc must belong to the same project as the package. Usetitle_overrideto set the section heading shown in the table of contents. - Compile with
compile_packageto generate the combined PDF.
add_calc_to_package appends in order — call it once per calc in the order you want them to appear. get_package returns the current ordered item list so you can confirm the contents before compiling.
Compiling#
compile_package builds the PDF and attaches it to the project's Files, returning the package id, the compile timestamp, and the resulting file_id. You can recompile any time after adding more calcs; the latest compiled PDF is tracked on the package.
Compile a package after every calc you run through Claude that you want included, or build the whole package first and compile once at the end. Either way the PDF lands in the project's Files for download or sharing.
Related#
- Packages — the package concept and web-app workflow.
- Reports — how individual calc report PDFs work.
- Projects & Calcs — find the calc IDs to add.