Report Builder
Build data reports from a declarative definition. Loads sources (IAPI services or MAPI entities), filters them into groups, formats each row, and writes the result to the report_row entity for a page to render. Used together with pdf_document/render-page for scheduled PDF reports.
Endpoints (1)
Validate a report definition without running it. Returns every problem found, or confirms the spec is valid and echoes the accepted vocabulary. Validation is STRICT: unknown keys are errors rather than being ignored, because a misspelled operator that gets silently skipped produces a report that looks right and is wrong — and these reports run unattended. Always validate before storing a definition as reports/{report}.json.
| Field | Type | Required | Description |
|---|---|---|---|
spec |
object | ✓ Yes | The report definition. Top-level keys: report (identifier), title (optional), sources (array, where the data comes from), groups (array, how it is filtered and mapped to report_row columns). |
MCP Tool Names
When using this integration through an AI assistant (Claude, ChatGPT, Cursor, etc.), the endpoints are available as MCP tools:
| Endpoint | MCP Tool Name |
|---|---|
| validate | report_builder_validate |
Website