list_journals
Retrieve and filter accounting journal entries with pagination to manage financial records in Siigo's electronic invoicing system.
Instructions
List journal entries (accounting vouchers) with pagination.
Args: page: Page number (starts at 1) page_size: Number of results per page (max 100) date_start: Filter by start date (YYYY-MM-DD format) date_end: Filter by end date (YYYY-MM-DD format)
Returns paginated list of journal entries with navigation links.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| page_size | No | ||
| date_start | No | ||
| date_end | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/siigo_mcp/tools/journals.py:10-35 (handler)Core handler function for list_journals tool: handles parameters, calls Siigo API /journals endpoint with pagination and date filters.
@mcp.tool async def list_journals( ctx: Context, page: int = 1, page_size: int = 25, date_start: str | None = None, date_end: str | None = None, ) -> dict[str, Any]: """List journal entries (accounting vouchers) with pagination. Args: page: Page number (starts at 1) page_size: Number of results per page (max 100) date_start: Filter by start date (YYYY-MM-DD format) date_end: Filter by end date (YYYY-MM-DD format) Returns paginated list of journal entries with navigation links. """ params: dict[str, Any] = {"page": page, "page_size": min(page_size, 100)} if date_start: params["date_start"] = date_start if date_end: params["date_end"] = date_end return await get_client(ctx).get("/journals", params=params) - src/siigo_mcp/tools/discovery.py:108-108 (registration)Maps tool name 'list_journals' to its implementation in journals.list_journals for dynamic/lazy tool execution.
"list_journals": journals.list_journals, - Tool index metadata defining name, category, and summary for discovery and list_siigo_tools.
{"name": "list_journals", "category": "journals", "summary": "List journal entries with pagination"},