@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 +1 -1
- package/src/client.js +1 -1
- package/src/index.js +42 -34
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@expensebot/mcp-server-auth",
|
|
3
|
-
"version": "0.6.
|
|
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.
|
|
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
|
-
"
|
|
187
|
-
"
|
|
188
|
-
"
|
|
189
|
-
"
|
|
190
|
-
"
|
|
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', '
|
|
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.
|
|
748
|
-
"
|
|
749
|
-
"
|
|
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) —
|
|
1086
|
-
"
|
|
1087
|
-
"
|
|
1088
|
-
"
|
|
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
|
|
1113
|
-
"
|
|
1114
|
-
"
|
|
1115
|
-
"
|
|
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
|
-
"
|
|
1153
|
-
"top categories and merchants, plus
|
|
1154
|
-
"
|
|
1155
|
-
"
|
|
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
|
|
1173
|
-
"
|
|
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
|
-
"
|
|
1208
|
-
"
|
|
1209
|
-
"confirm:true
|
|
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.
|
|
1736
|
+
{ name: "expensebot-auth", version: "0.6.3" },
|
|
1729
1737
|
{ capabilities: { tools: {} } }
|
|
1730
1738
|
);
|
|
1731
1739
|
|