@expensebot/mcp-server-auth 0.6.17 → 0.6.18

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,15 @@
1
1
  # @expensebot/mcp-server-auth
2
2
 
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.
3
+ 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
4
 
5
- **50 tools** across:
5
+ **51 tools** across:
6
6
  - **Search & analytics** — `search_expenses`, `get_spending_summary`, `get_deep_analytics`, `list_categories`, `list_tags`, `list_income_categories`, `search_knowledge`
7
7
  - **Income & P&L** *(v0.6.0)* — `get_income_summary`, `get_pnl`, `get_per_tag_pnl`
8
8
  - **Mileage & Subscriptions** *(v0.6.1)* — `get_mileage_summary`, `get_subscription_audit`
9
9
  - **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
10
  - **Gmail** — `scan_gmail`, `process_gmail_receipts`, `scan_gmail_years`, `get_scan_status`
11
11
  - **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`
12
+ - **Expense review** — `get_expense_splits`, `get_monthly_books_review`, `get_credits_refunds`, `get_client_advance_balances`
13
13
  - **Compliance & tax** — `check_compliance`, `fix_compliance`, `check_tax_deductibility`
14
14
  - **Activity, tracing & onboarding** — `get_recent_activity`, `trace_document`, `get_signup_link`, `get_pricing`, `check_feature`, `start_trial_link`
15
15
  - **Business what-if** — `whatif_afford`, `whatif_client`, `whatif_tax_setaside`
@@ -95,6 +95,11 @@ https://mcp.expensebot.ai/mcp
95
95
 
96
96
  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
97
 
98
+ This repository publishes both connection methods in `server.json`: the remote
99
+ Streamable HTTP server for OAuth-capable clients and the npm stdio package for
100
+ local clients. Host directories may expose either or both depending on their
101
+ transport and authentication support.
102
+
98
103
  ## Token model
99
104
 
100
105
  - **Personal Access Tokens (PAT)** scoped to your ExpenseBot account
@@ -103,9 +108,11 @@ Complete ExpenseBot sign-in and consent in the browser. No personal token or man
103
108
  - All actions audit-logged server-side
104
109
  - Tokens stored as SHA-256 hashes; CASA Tier 2 certified
105
110
 
106
- ## Listed on
111
+ ## Discovery
107
112
 
108
- - **Official MCP Registry** — `io.github.TotesMagotes/mcp-server-auth`
113
+ - **Official MCP Registry** — active as
114
+ `io.github.TotesMagotes/mcp-server-auth`; version `0.6.18` is the current
115
+ listing with both npm stdio and remote Streamable HTTP transports
109
116
  - **awesome-mcp-servers** — Finance & Fintech section
110
117
  - **Glama** — <https://glama.ai/mcp/servers/TotesMagotes/expensebot>
111
118
 
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "@expensebot/mcp-server-auth",
3
- "version": "0.6.17",
3
+ "version": "0.6.18",
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
6
  "bin": {
7
7
  "expensebot-mcp-auth": "src/index.js"
8
8
  },
@@ -21,6 +21,10 @@
21
21
  "receipts",
22
22
  "ai",
23
23
  "claude",
24
+ "chatgpt",
25
+ "gemini",
26
+ "copilot",
27
+ "bookkeeping",
24
28
  "accounting"
25
29
  ],
26
30
  "engines": {
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.18",
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.18" },
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 = [