@mintline/mcp 1.1.1 → 1.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +69 -9
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -37,25 +37,85 @@ The Mintline tools will now be available.
37
37
 
38
38
  ## Available Tools
39
39
 
40
+ ### Receipts & Transactions
41
+
40
42
  | Tool | Description |
41
43
  |------|-------------|
42
- | `list_receipts` | Search and filter receipts by vendor, status |
43
- | `get_receipt` | Get receipt details with line items |
44
- | `list_transactions` | Search and filter bank transactions |
45
- | `get_transaction` | Get transaction details |
44
+ | `list_receipts` | Search and filter receipts by vendor name, date range, or match status |
45
+ | `get_receipt` | Get detailed receipt info including line items and matched transaction |
46
+ | `list_transactions` | Search and filter bank transactions by description or status |
47
+ | `get_transaction` | Get detailed transaction information |
46
48
  | `list_statements` | List uploaded bank statements |
47
- | `list_matches` | View proposed receipt-transaction matches |
48
- | `confirm_match` | Confirm a proposed match |
49
- | `reject_match` | Reject a proposed match |
49
+
50
+ ### Matching
51
+
52
+ | Tool | Description |
53
+ |------|-------------|
54
+ | `list_matches` | View proposed matches between receipts and transactions |
55
+ | `confirm_match` | Confirm a proposed match (links receipt to transaction permanently) |
56
+ | `reject_match` | Reject a proposed match (won't be suggested again) |
57
+
58
+ ### Analytics
59
+
60
+ | Tool | Description |
61
+ |------|-------------|
62
+ | `spending_summary` | Get spending totals with flexible grouping (total, vendor, month, week, day) |
63
+ | `top_vendors` | Get top vendors ranked by total spending |
64
+ | `spending_trends` | Get monthly spending trends over time |
65
+ | `unmatched_summary` | Get summary of items needing attention (unmatched receipts, transactions, proposed matches) |
66
+
67
+ ## Tool Parameters
68
+
69
+ ### list_receipts
70
+ - `search` (string) - Search by vendor name
71
+ - `status` (string) - Filter: "all", "matched", "unmatched", "hidden"
72
+ - `limit` (number) - Max results (default: 20)
73
+
74
+ ### list_transactions
75
+ - `search` (string) - Search by transaction description
76
+ - `status` (string) - Filter: "all", "matched", "unmatched", "hidden"
77
+ - `statementId` (string) - Filter by bank statement ID
78
+ - `limit` (number) - Max results (default: 20)
79
+
80
+ ### list_matches
81
+ - `status` (string) - Filter: "proposed", "confirmed", "rejected" (default: proposed)
82
+ - `limit` (number) - Max results (default: 20)
83
+
84
+ ### spending_summary
85
+ - `groupBy` (string) - "total", "vendor", "month", "week", "day" (default: total)
86
+ - `dateFrom` (string) - Start date (YYYY-MM-DD)
87
+ - `dateTo` (string) - End date (YYYY-MM-DD)
88
+ - `vendorId` (string) - Filter by specific vendor
89
+ - `limit` (number) - Max results for grouped queries (default: 20)
90
+
91
+ ### top_vendors
92
+ - `limit` (number) - Number of vendors to return (default: 10)
93
+
94
+ ### spending_trends
95
+ - `months` (number) - Number of months to include (default: 6)
50
96
 
51
97
  ## Example Prompts
52
98
 
99
+ ### Receipts & Transactions
53
100
  - "Show me my unmatched receipts"
54
101
  - "Find receipts from Amazon"
55
- - "What transactions need matching?"
56
- - "Confirm the top match"
102
+ - "List transactions from my Chase statement"
57
103
  - "Show details for receipt rcpt_01abc123"
58
104
 
105
+ ### Matching
106
+ - "What matches need my review?"
107
+ - "Confirm the top match"
108
+ - "Reject match mtch_01xyz789 - wrong vendor"
109
+
110
+ ### Analytics
111
+ - "How much did I spend this month?"
112
+ - "What are my top vendors by spending?"
113
+ - "Show me spending trends for the last 6 months"
114
+ - "Break down my spending by week"
115
+ - "How much did I spend at AWS last quarter?"
116
+ - "What needs my attention?" (shows unmatched items)
117
+ - "Do I have any large transactions without receipts?"
118
+
59
119
  ## Environment Variables
60
120
 
61
121
  | Variable | Required | Description |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mintline/mcp",
3
- "version": "1.1.1",
3
+ "version": "1.1.2",
4
4
  "description": "MCP server for Mintline - connect AI assistants to your receipts and transactions",
5
5
  "main": "dist/index.js",
6
6
  "bin": {