@expensebot/mcp-server-auth 0.6.2 → 0.6.3

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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@expensebot/mcp-server-auth",
3
- "version": "0.6.2",
3
+ "version": "0.6.3",
4
4
  "mcpName": "io.github.TotesMagotes/mcp-server-auth",
5
5
  "description": "Authenticated MCP server for ExpenseBot — lets Claude Desktop, Cursor, and other AI assistants search your expenses, create reports, and analyze spending using your actual ExpenseBot data.",
6
6
  "bin": {
package/src/client.js CHANGED
@@ -20,7 +20,7 @@ export class ExpenseBotClient {
20
20
  headers: {
21
21
  Authorization: `Bearer ${this.token}`,
22
22
  "Content-Type": "application/json",
23
- "User-Agent": "expensebot-mcp-auth/0.6.2",
23
+ "User-Agent": "expensebot-mcp-auth/0.6.3",
24
24
  ...options.headers,
25
25
  },
26
26
  body: options.body ? JSON.stringify(options.body) : undefined,
package/src/index.js CHANGED
@@ -183,18 +183,11 @@ const TOOLS = [
183
183
  {
184
184
  name: "get_spending_summary",
185
185
  description:
186
- "Unified analytics endpoint — handles expenses, income, P&L, " +
187
- "per-tag P&L (per-client / per-property / per-event), Schedule B " +
188
- "drill-in (interest, dividends, tax refunds, security deposits), " +
189
- "mileage, and subscription audits in ONE tool. Examples: 'how much " +
190
- "did I spend last month', 'income YTD', 'rental income by " +
191
- "property', 'P&L for Q1', 'profit by client', 'mileage this year', " +
192
- "'recurring subscriptions', 'price increases', 'duplicate " +
193
- "subscriptions', 'trial conversions'. Supports period comparison " +
194
- "phrasing — 'this year vs last' (YoY), 'vs last month' (MoM), 'Q1 " +
195
- "vs Q2' (QoQ), same-month-prev-year. Margin renders as multiplier " +
196
- "('expenses 5.4× revenue') when in loss territory. Returns: " +
197
- "{ message, data: { total, breakdown?, comparison?, sampleMeta? } }.",
186
+ "Summarize the user's recorded expenses with totals and breakdowns by " +
187
+ "category, merchant, month, tag, source, or payment method. Supports " +
188
+ "date ranges, period comparisons, and total, count, or average metrics. " +
189
+ "Read-only. Returns: { message, data: { total, breakdown?, comparison?, " +
190
+ "sampleMeta? } }.",
198
191
  inputSchema: {
199
192
  type: "object",
200
193
  properties: {
@@ -202,7 +195,7 @@ const TOOLS = [
202
195
  query: {
203
196
  type: "string",
204
197
  description:
205
- "Natural language question (e.g., 'how much did I spend in March', 'rental income by property')",
198
+ "Natural language question (e.g., 'how much did I spend in March', 'top merchants this quarter')",
206
199
  },
207
200
  categories: { type: "array", items: { type: "string" } },
208
201
  dateRange: DATE_RANGE_SCHEMA,
@@ -744,9 +737,10 @@ const TOOLS = [
744
737
  description:
745
738
  "Show what the user (or their AI assistants) has recently done in " +
746
739
  "ExpenseBot via this MCP server: which tools were called, when, with " +
747
- "what arguments, and whether they succeeded. Useful for ambient " +
748
- "questions like 'what did I do this week', 'did my last receipt " +
749
- "submission work', or to give the user transparency into AI-assisted " +
740
+ "what arguments, and whether they succeeded. This is a log of assistant " +
741
+ "TOOL CALLS, not the processing history of a document. Useful for " +
742
+ "questions like 'what did I do this week' or 'which tools has my " +
743
+ "assistant run', and to give the user transparency into AI-assisted " +
750
744
  "actions. Returns the most recent N entries from the audit log " +
751
745
  "(default 20, max 100).",
752
746
  inputSchema: {
@@ -1082,10 +1076,11 @@ const TOOLS = [
1082
1076
  {
1083
1077
  name: "list_client_invoices",
1084
1078
  description:
1085
- "List the user's issued client invoices (accounts receivable) — open " +
1086
- "or paid, with totals and due dates. Use when the user asks what " +
1087
- "clients owe them, which invoices are outstanding or overdue, or " +
1088
- "before running whatif_client on a client. Read-only.",
1079
+ "List the user's issued client invoices (accounts receivable) — who owes " +
1080
+ "them money, how much, and when it is due. Examples: 'which invoices are " +
1081
+ "outstanding', 'what does Acme still owe me', 'any overdue invoices', " +
1082
+ "'how much am I waiting to get paid'. status accepts 'open' (default), " +
1083
+ "'paid', or 'all'. Read-only — it does not create, send, or mark invoices paid.",
1089
1084
  inputSchema: {
1090
1085
  type: "object",
1091
1086
  properties: {
@@ -1109,10 +1104,12 @@ const TOOLS = [
1109
1104
  {
1110
1105
  name: "get_expense_splits",
1111
1106
  description:
1112
- "Show how an expense is split or allocated across categories, clients, " +
1113
- "properties, or business and personal portions. Returns one parent " +
1114
- "payment with nested allocation lines; it never treats split lines as " +
1115
- "separate expenses. Read-only — edit splits in ExpenseBot's Review workspace.",
1107
+ "Show how an expense was split across categories, clients, properties, or " +
1108
+ "business vs personal portions. Returns the single parent payment with its " +
1109
+ "nested allocation lines — split lines are never counted as separate " +
1110
+ "expenses, so totals stay correct. Examples: 'how is that expense split', " +
1111
+ "'what was the business portion of that bill', 'show the allocation for " +
1112
+ "this receipt'. Read-only — splits are edited in ExpenseBot's Review workspace.",
1116
1113
  inputSchema: {
1117
1114
  type: "object",
1118
1115
  properties: {
@@ -1122,6 +1119,8 @@ const TOOLS = [
1122
1119
  description: "Optional Receipt ID for one expense.",
1123
1120
  },
1124
1121
  dateRange: {
1122
+ description:
1123
+ "Optional window to search for split expenses. Both bounds inclusive, YYYY-MM-DD.",
1125
1124
  type: "object",
1126
1125
  properties: {
1127
1126
  startDate: {
@@ -1149,10 +1148,13 @@ const TOOLS = [
1149
1148
  {
1150
1149
  name: "get_monthly_books_review",
1151
1150
  description:
1152
- "Get the user's Monthly Books Review: recorded income, spending, net, " +
1153
- "top categories and merchants, plus deterministic cash-pulse alerts for " +
1154
- "one calendar month. Defaults to the last completed month. Advisory " +
1155
- "fields are estimates and retain ExpenseBot's tax-professional disclaimer.",
1151
+ "Month-end summary of the user's books for one calendar month: income " +
1152
+ "recorded, money spent, net, top spending categories and merchants, plus " +
1153
+ "alerts for anything unusual that month. Examples: 'how did last month " +
1154
+ "go', 'close out my books for June', 'monthly review', 'what did I make " +
1155
+ "and spend in May'. Defaults to the last completed month. Figures come " +
1156
+ "from the user's own recorded data; advisory notes are estimates, not " +
1157
+ "tax advice.",
1156
1158
  inputSchema: {
1157
1159
  type: "object",
1158
1160
  properties: {
@@ -1169,14 +1171,19 @@ const TOOLS = [
1169
1171
  {
1170
1172
  name: "get_credits_refunds",
1171
1173
  description:
1172
- "List recently reviewed card refunds, rewards, and statement credits that " +
1173
- "are already recorded as negative expenses or matched to an existing offset. " +
1174
+ "List card refunds, cashback/rewards, and statement credits that " +
1175
+ "ExpenseBot has already recorded — either as negative expenses or matched " +
1176
+ "against the original charge. Examples: 'did my refund come through', " +
1177
+ "'show my statement credits', 'was that return recorded'. Returns the " +
1178
+ "most recent items (default 25, newest first); narrow with dateRange. " +
1174
1179
  "Read-only: it never scans cards, changes review decisions, or adds rows.",
1175
1180
  inputSchema: {
1176
1181
  type: "object",
1177
1182
  properties: {
1178
1183
  clientEmail: CLIENT_EMAIL_SCHEMA,
1179
1184
  dateRange: {
1185
+ description:
1186
+ "Optional window to narrow results. Both bounds inclusive, YYYY-MM-DD.",
1180
1187
  type: "object",
1181
1188
  properties: {
1182
1189
  startDate: {
@@ -1204,9 +1211,10 @@ const TOOLS = [
1204
1211
  "Client – Acme'). Identify it only by the exact expenseId returned by " +
1205
1212
  "search_expenses (the full Receipt ID from Column Q). Never use a date, " +
1206
1213
  "displayed number, or sheet row number as expenseId. " +
1207
- "ALWAYS call first WITHOUT confirm to preview the current→proposed " +
1208
- "change, then ask the user to confirm, then call again with " +
1209
- "confirm:true. Only category/tag/merchant/businessPurpose are " +
1214
+ "Two-phase operation: calls with confirm omitted or false return a " +
1215
+ "preview of the current→proposed change and make no change. After user " +
1216
+ "confirmation, a call with confirm:true applies the proposed change. " +
1217
+ "Only category/tag/merchant/businessPurpose are " +
1210
1218
  "editable — amounts, dates, and notes are not editable via the " +
1211
1219
  "assistant. Does not create or delete rows.",
1212
1220
  inputSchema: {
@@ -1725,7 +1733,7 @@ function formatResult(result) {
1725
1733
 
1726
1734
  async function main() {
1727
1735
  const server = new Server(
1728
- { name: "expensebot-auth", version: "0.6.2" },
1736
+ { name: "expensebot-auth", version: "0.6.3" },
1729
1737
  { capabilities: { tools: {} } }
1730
1738
  );
1731
1739