@expensebot/mcp-server-auth 0.6.17 → 0.6.19

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/README.md CHANGED
@@ -1,15 +1,21 @@
1
+ <p align="center">
2
+ <a href="https://www.expensebot.ai/mcp">
3
+ <img src="https://raw.githubusercontent.com/TotesMagotes/expensebot-mcp/main/assets/expensebot.png" alt="ExpenseBot logo" width="160" height="160">
4
+ </a>
5
+ </p>
6
+
1
7
  # @expensebot/mcp-server-auth
2
8
 
3
- Authenticated MCP (Model Context Protocol) server for [ExpenseBot](https://www.expensebot.ai). Lets Claude Desktop, Cursor, Claude Code, Continue, Cline, Windsurf, and any MCP-compatible AI assistant search receipts, submit photos, scan Gmail, create reports, and analyze spending using your real ExpenseBot account.
9
+ Authenticated MCP (Model Context Protocol) server for [ExpenseBot](https://www.expensebot.ai). Lets Copilot, Gemini, Replit, Cursor, Claude Desktop, Claude Code, Continue, Cline, Windsurf, and other MCP-compatible assistants search receipts, submit photos and PDFs, scan Gmail, create reports, and analyze spending using your real ExpenseBot account.
4
10
 
5
- **50 tools** across:
11
+ **51 tools** across:
6
12
  - **Search & analytics** — `search_expenses`, `get_spending_summary`, `get_deep_analytics`, `list_categories`, `list_tags`, `list_income_categories`, `search_knowledge`
7
13
  - **Income & P&L** *(v0.6.0)* — `get_income_summary`, `get_pnl`, `get_per_tag_pnl`
8
14
  - **Mileage & Subscriptions** *(v0.6.1)* — `get_mileage_summary`, `get_subscription_audit`
9
15
  - **Receipt and expense capture** — `submit_receipt` (photo/PDF), `get_last_receipt_result`, `add_cash_expense` (including confirmed client advances), `add_mileage_entry`, `add_income`, `add_income_from_file` (screenshot/PDF, parse-preview-confirm), `add_income_from_csv` (CSV/TSV/text, parse-preview-confirm), `parse_expense`, `get_expense_by_id`, `update_expense`, `group_expenses`, `correct_expenses`, `get_spreadsheet_url`
10
16
  - **Gmail** — `scan_gmail`, `process_gmail_receipts`, `scan_gmail_years`, `get_scan_status`
11
17
  - **Reports & invoicing** — `create_report`, `list_reports`, `get_report_details`, `share_report`, `export_report`, `list_client_invoices`
12
- - **Expense review** — `get_expense_splits`, `get_monthly_books_review`, `get_credits_refunds`
18
+ - **Expense review** — `get_expense_splits`, `get_monthly_books_review`, `get_credits_refunds`, `get_client_advance_balances`
13
19
  - **Compliance & tax** — `check_compliance`, `fix_compliance`, `check_tax_deductibility`
14
20
  - **Activity, tracing & onboarding** — `get_recent_activity`, `trace_document`, `get_signup_link`, `get_pricing`, `check_feature`, `start_trial_link`
15
21
  - **Business what-if** — `whatif_afford`, `whatif_client`, `whatif_tax_setaside`
@@ -95,6 +101,11 @@ https://mcp.expensebot.ai/mcp
95
101
 
96
102
  Complete ExpenseBot sign-in and consent in the browser. No personal token or manual OAuth client secret is needed. If the client supports only local/stdio MCP, use the npm setup above. Never email a token or paste it into an AI conversation.
97
103
 
104
+ This repository publishes both connection methods in `server.json`: the remote
105
+ Streamable HTTP server for OAuth-capable clients and the npm stdio package for
106
+ local clients. Host directories may expose either or both depending on their
107
+ transport and authentication support.
108
+
98
109
  ## Token model
99
110
 
100
111
  - **Personal Access Tokens (PAT)** scoped to your ExpenseBot account
@@ -103,9 +114,11 @@ Complete ExpenseBot sign-in and consent in the browser. No personal token or man
103
114
  - All actions audit-logged server-side
104
115
  - Tokens stored as SHA-256 hashes; CASA Tier 2 certified
105
116
 
106
- ## Listed on
117
+ ## Discovery
107
118
 
108
- - **Official MCP Registry** — `io.github.TotesMagotes/mcp-server-auth`
119
+ - **Official MCP Registry** — active as
120
+ `io.github.TotesMagotes/mcp-server-auth`; version `0.6.19` is the current
121
+ listing with both npm stdio and remote Streamable HTTP transports
109
122
  - **awesome-mcp-servers** — Finance & Fintech section
110
123
  - **Glama** — <https://glama.ai/mcp/servers/TotesMagotes/expensebot>
111
124
 
package/package.json CHANGED
@@ -1,8 +1,16 @@
1
1
  {
2
2
  "name": "@expensebot/mcp-server-auth",
3
- "version": "0.6.17",
3
+ "version": "0.6.19",
4
4
  "mcpName": "io.github.TotesMagotes/mcp-server-auth",
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.",
5
+ "description": "ExpenseBot MCP server for receipt and income capture, Gmail scans, spending analytics, and reviewed expense reports from AI assistants.",
6
+ "homepage": "https://www.expensebot.ai/mcp",
7
+ "repository": {
8
+ "type": "git",
9
+ "url": "git+https://github.com/TotesMagotes/expensebot-mcp.git"
10
+ },
11
+ "bugs": {
12
+ "url": "https://github.com/TotesMagotes/expensebot-mcp/issues"
13
+ },
6
14
  "bin": {
7
15
  "expensebot-mcp-auth": "src/index.js"
8
16
  },
@@ -21,6 +29,10 @@
21
29
  "receipts",
22
30
  "ai",
23
31
  "claude",
32
+ "chatgpt",
33
+ "gemini",
34
+ "copilot",
35
+ "bookkeeping",
24
36
  "accounting"
25
37
  ],
26
38
  "engines": {
@@ -36,6 +48,10 @@
36
48
  "gen-descriptions": "node scripts/generate-descriptions-from-kb.js",
37
49
  "prepublishOnly": "node scripts/sync-check.js && node src/test.js"
38
50
  },
39
- "author": "ExpenseBot",
51
+ "author": {
52
+ "name": "ExpenseBot",
53
+ "email": "support@expensebot.ai",
54
+ "url": "https://www.expensebot.ai"
55
+ },
40
56
  "license": "MIT"
41
57
  }
@@ -0,0 +1,10 @@
1
+ {
2
+ "_meta": {
3
+ "generatedAt": "2026-05-07T05:13:24.014Z",
4
+ "sourceKb": "../server/config/kb/entries/income-and-pnl-analytics.md",
5
+ "note": "Auto-generated from KB. Do NOT edit by hand — re-run `npm run gen-descriptions` after the KB changes."
6
+ },
7
+ "get_income_summary": "Get income totals and breakdowns from the Income tab — Schedule C / T2125 basis. Excludes Schedule B (interest, dividends), tax refunds, and security deposits (mirrors year-end report routing). Examples: \"How much income YTD?\", \"Income by source\", \"by month\", \"by payment method\".",
8
+ "get_pnl": "Compute Profit & Loss across the Income tab and expenses. Examples: \"Am I profitable this year?\", \"Net income last quarter\", \"What's my margin?\", \"P&L for Q1\".",
9
+ "get_per_tag_pnl": "Per-tag P&L — revenue, cost, profit, and margin grouped by tag. Requires both income AND expense rows to be tagged consistently. Examples: ."
10
+ }
package/src/client.js CHANGED
@@ -46,7 +46,7 @@ export class ExpenseBotClient {
46
46
  headers: {
47
47
  Authorization: `Bearer ${this.token}`,
48
48
  "Content-Type": "application/json",
49
- "User-Agent": "expensebot-mcp-auth/0.6.17",
49
+ "User-Agent": "expensebot-mcp-auth/0.6.19",
50
50
  "X-ExpenseBot-MCP-Transport": "stdio",
51
51
  ...options.headers,
52
52
  },
package/src/index.js CHANGED
@@ -1729,6 +1729,34 @@ const TOOLS = [
1729
1729
  },
1730
1730
  },
1731
1731
  },
1732
+ {
1733
+ name: "get_client_advance_balances",
1734
+ description:
1735
+ "Read the same per-client advance balances shown in ExpenseBot's Open " +
1736
+ "Balances section. Use for questions like 'how much of Acme's advance " +
1737
+ "remains?', 'which client floats are still open?', or 'do I owe a client " +
1738
+ "a refund?'. A negative ledger balance means money remains to refund; a " +
1739
+ "positive balance means the client owes the user. Returns the existing " +
1740
+ "app handoff for Refund leftover or Bill Client. Read-only: never records " +
1741
+ "a refund, creates an invoice, or recomputes the ledger in model prose.",
1742
+ inputSchema: {
1743
+ type: "object",
1744
+ properties: {
1745
+ clientEmail: CLIENT_EMAIL_SCHEMA,
1746
+ clientName: {
1747
+ type: "string",
1748
+ description:
1749
+ "Optional client name or canonical Client tag. Omit to list all open balances.",
1750
+ },
1751
+ days: {
1752
+ type: "integer",
1753
+ minimum: 30,
1754
+ maximum: 3650,
1755
+ description: "Lookback window in days (default 365).",
1756
+ },
1757
+ },
1758
+ },
1759
+ },
1732
1760
  {
1733
1761
  name: "group_expenses",
1734
1762
  description:
@@ -2386,6 +2414,15 @@ async function handleTool(name, args) {
2386
2414
  })
2387
2415
  );
2388
2416
 
2417
+ case "get_client_advance_balances":
2418
+ return formatResult(
2419
+ await client.execute("get_client_advance_balances", {
2420
+ clientEmail: args.clientEmail,
2421
+ clientName: args.clientName,
2422
+ days: args.days,
2423
+ })
2424
+ );
2425
+
2389
2426
  case "group_expenses":
2390
2427
  return formatResult(
2391
2428
  await client.execute("group_expenses", {
@@ -2523,7 +2560,7 @@ function formatResult(result) {
2523
2560
 
2524
2561
  async function main() {
2525
2562
  const server = new Server(
2526
- { name: "expensebot-auth", version: "0.6.17" },
2563
+ { name: "expensebot-auth", version: "0.6.19" },
2527
2564
  { capabilities: { tools: {} }, instructions: SERVER_INSTRUCTIONS }
2528
2565
  );
2529
2566
 
package/src/test.js CHANGED
@@ -23,7 +23,7 @@ import { readStructuredHttpError } from "./client.js";
23
23
  const __dirname = path.dirname(fileURLToPath(import.meta.url));
24
24
  const SERVER_PATH = path.join(__dirname, "index.js");
25
25
 
26
- const EXPECTED_TOOL_COUNT = 50;
26
+ const EXPECTED_TOOL_COUNT = 51;
27
27
  const REQUIRED_TOOLS = [
28
28
  // v0.5.x
29
29
  "search_expenses",
@@ -59,6 +59,7 @@ const REQUIRED_TOOLS = [
59
59
  "get_expense_splits",
60
60
  "get_monthly_books_review",
61
61
  "get_credits_refunds",
62
+ "get_client_advance_balances",
62
63
  ];
63
64
 
64
65
  const REQUESTS = [