Skip to content

Add insight tools #68

@RadCod3

Description

@RadCod3

The Firefly III API has 24 insight endpoints organized in three categories:

  1. Expense Insights (/v1/insight/expense/*)
Endpoint Description Response Type
/expense/expense Expenses grouped by expense account InsightGroup
/expense/asset Expenses grouped by asset account InsightGroup
/expense/bill Expenses grouped by bill InsightGroup
/expense/no-bill Expenses without bills InsightTotal
/expense/budget Expenses grouped by budget InsightGroup
/expense/no-budget Expenses without budget InsightTotal
/expense/category Expenses grouped by category InsightGroup
/expense/no-category Expenses without category InsightTotal
/expense/tag Expenses grouped by tag InsightGroup
/expense/no-tag Expenses without tags InsightTotal
/expense/total Total expenses InsightTotal
  1. Income Insights (/v1/insight/income/*)
Endpoint Description Response Type
/income/revenue Income grouped by revenue account InsightGroup
/income/asset Income grouped by asset account InsightGroup
/income/category Income grouped by category InsightGroup
/income/no-category Income without category InsightTotal
/income/tag Income grouped by tag InsightGroup
/income/no-tag Income without tags InsightTotal
/income/total Total income InsightTotal
  1. Transfer Insights (/v1/insight/transfer/*)
Endpoint Description Response Type
/transfer/asset Transfers grouped by account InsightTransfer
/transfer/category Transfers grouped by category InsightGroup
/transfer/no-category Transfers without category InsightTotal
/transfer/tag Transfers grouped by tag InsightGroup
/transfer/no-tag Transfers without tags InsightTotal
/transfer/total Total transfers InsightTotal

We can support a subset of these endpoints by adding MCP tools for insights.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions