The Firefly III API has 24 insight endpoints organized in three categories:
- 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 |
- 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 |
- 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.
The Firefly III API has 24 insight endpoints organized in three categories:
/v1/insight/expense/*)/expense/expenseInsightGroup/expense/assetInsightGroup/expense/billInsightGroup/expense/no-billInsightTotal/expense/budgetInsightGroup/expense/no-budgetInsightTotal/expense/categoryInsightGroup/expense/no-categoryInsightTotal/expense/tagInsightGroup/expense/no-tagInsightTotal/expense/totalInsightTotal/v1/insight/income/*)/income/revenueInsightGroup/income/assetInsightGroup/income/categoryInsightGroup/income/no-categoryInsightTotal/income/tagInsightGroup/income/no-tagInsightTotal/income/totalInsightTotal/v1/insight/transfer/*)/transfer/assetInsightTransfer/transfer/categoryInsightGroup/transfer/no-categoryInsightTotal/transfer/tagInsightGroup/transfer/no-tagInsightTotal/transfer/totalInsightTotalWe can support a subset of these endpoints by adding MCP tools for insights.