Siigo MCP Server

Instructions

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,

• src/siigo_mcp/tools/discovery.py:54-54 (schema)

  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"},