@expensebot/mcp-server-auth 0.6.19 → 0.6.20

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
@@ -8,7 +8,7 @@
8
8
 
9
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.
10
10
 
11
- **51 tools** across:
11
+ **54 tools** across:
12
12
  - **Search & analytics** — `search_expenses`, `get_spending_summary`, `get_deep_analytics`, `list_categories`, `list_tags`, `list_income_categories`, `search_knowledge`
13
13
  - **Income & P&L** *(v0.6.0)* — `get_income_summary`, `get_pnl`, `get_per_tag_pnl`
14
14
  - **Mileage & Subscriptions** *(v0.6.1)* — `get_mileage_summary`, `get_subscription_audit`
@@ -16,6 +16,7 @@ Authenticated MCP (Model Context Protocol) server for [ExpenseBot](https://www.e
16
16
  - **Gmail** — `scan_gmail`, `process_gmail_receipts`, `scan_gmail_years`, `get_scan_status`
17
17
  - **Reports & invoicing** — `create_report`, `list_reports`, `get_report_details`, `share_report`, `export_report`, `list_client_invoices`
18
18
  - **Expense review** — `get_expense_splits`, `get_monthly_books_review`, `get_credits_refunds`, `get_client_advance_balances`
19
+ - **Accounting destinations** — `get_accounting_integration_status`, `send_report_to_accounting`, `get_accounting_push_status` (provider-neutral review/confirm/status contract; Zoho Books is the first enabled adapter)
19
20
  - **Compliance & tax** — `check_compliance`, `fix_compliance`, `check_tax_deductibility`
20
21
  - **Activity, tracing & onboarding** — `get_recent_activity`, `trace_document`, `get_signup_link`, `get_pricing`, `check_feature`, `start_trial_link`
21
22
  - **Business what-if** — `whatif_afford`, `whatif_client`, `whatif_tax_setaside`
@@ -117,7 +118,7 @@ transport and authentication support.
117
118
  ## Discovery
118
119
 
119
120
  - **Official MCP Registry** — active as
120
- `io.github.TotesMagotes/mcp-server-auth`; version `0.6.19` is the current
121
+ `io.github.TotesMagotes/mcp-server-auth`; version `0.6.20` is the current
121
122
  listing with both npm stdio and remote Streamable HTTP transports
122
123
  - **awesome-mcp-servers** — Finance & Fintech section
123
124
  - **Glama** — <https://glama.ai/mcp/servers/TotesMagotes/expensebot>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@expensebot/mcp-server-auth",
3
- "version": "0.6.19",
3
+ "version": "0.6.20",
4
4
  "mcpName": "io.github.TotesMagotes/mcp-server-auth",
5
5
  "description": "ExpenseBot MCP server for receipt and income capture, Gmail scans, spending analytics, and reviewed expense reports from AI assistants.",
6
6
  "homepage": "https://www.expensebot.ai/mcp",
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.19",
49
+ "User-Agent": "expensebot-mcp-auth/0.6.20",
50
50
  "X-ExpenseBot-MCP-Transport": "stdio",
51
51
  ...options.headers,
52
52
  },
package/src/index.js CHANGED
@@ -1088,6 +1088,107 @@ const TOOLS = [
1088
1088
  required: [],
1089
1089
  },
1090
1090
  },
1091
+ {
1092
+ name: "get_accounting_integration_status",
1093
+ description:
1094
+ "Check whether an accounting destination is connected and ready for owner-authorized " +
1095
+ "agent posting. Returns the selected organization/account, authorization state, rollout " +
1096
+ "state, and a setup or reconnect link. This is read-only and never posts accounting data. " +
1097
+ "Zoho Books is the first supported provider; the contract is shared for future providers.",
1098
+ inputSchema: {
1099
+ type: "object",
1100
+ properties: {
1101
+ provider: {
1102
+ type: "string",
1103
+ enum: ["zoho_books"],
1104
+ description: "Accounting destination provider.",
1105
+ },
1106
+ },
1107
+ required: ["provider"],
1108
+ },
1109
+ },
1110
+ {
1111
+ name: "send_report_to_accounting",
1112
+ description:
1113
+ "Review and then post an ExpenseBot report to the owner's accounting destination. " +
1114
+ "STEP 1: call with provider, reportId, and optional mode/mappings, without confirm. The " +
1115
+ "server reads the live report and destination, applies Omit/Personal/split/date/currency " +
1116
+ "rules, checks bank-feed matches, and returns the complete proposal plus proposalId. " +
1117
+ "NOTHING is posted in step 1. Show the complete proposal and ask for approval. STEP 2: " +
1118
+ "call with only provider, proposalId, and confirm:true. The server posts only the frozen, " +
1119
+ "account-bound proposal, revalidates live state, and rejects changed reports or mappings. " +
1120
+ "Never add mapping fields to the confirmation call. Owner accounts only; acting for a " +
1121
+ "client is not supported. Zoho Books is the first supported provider.",
1122
+ inputSchema: {
1123
+ type: "object",
1124
+ properties: {
1125
+ provider: {
1126
+ type: "string",
1127
+ enum: ["zoho_books"],
1128
+ description: "Accounting destination provider.",
1129
+ },
1130
+ reportId: {
1131
+ type: "string",
1132
+ description: "Step 1 only: ExpenseBot report ID owned by the signed-in account.",
1133
+ },
1134
+ mode: {
1135
+ type: "string",
1136
+ enum: ["auto", "expense", "bill"],
1137
+ description: "Step 1 only: automatic document treatment, paid expenses, or bills.",
1138
+ },
1139
+ accountMappings: {
1140
+ type: "object",
1141
+ additionalProperties: { type: "string" },
1142
+ description: "Step 1 only: ExpenseBot category to live destination account ID overrides.",
1143
+ },
1144
+ taxMappings: {
1145
+ type: "object",
1146
+ additionalProperties: { type: "string" },
1147
+ description: "Step 1 only: observed tax-rate string to live destination tax ID overrides.",
1148
+ },
1149
+ reportingTagMappings: {
1150
+ type: "object",
1151
+ additionalProperties: {
1152
+ type: "object",
1153
+ properties: {
1154
+ tagId: { type: "string" },
1155
+ optionId: { type: "string" },
1156
+ },
1157
+ required: ["tagId", "optionId"],
1158
+ },
1159
+ description: "Step 1 only: ExpenseBot tag to live destination reporting-tag option.",
1160
+ },
1161
+ forceRepush: {
1162
+ type: "boolean",
1163
+ description: "Step 1 only: explicitly include disclosed uncertain prior outcomes in the frozen proposal.",
1164
+ },
1165
+ proposalId: {
1166
+ type: "string",
1167
+ description: "Step 2 only: proposalId returned by the read-only preview.",
1168
+ },
1169
+ confirm: {
1170
+ type: "boolean",
1171
+ description: "Step 2 only: true posts the exact staged proposal. No other options may change.",
1172
+ },
1173
+ },
1174
+ required: ["provider"],
1175
+ },
1176
+ },
1177
+ {
1178
+ name: "get_accounting_push_status",
1179
+ description:
1180
+ "Read the terminal posting and reconciliation status for an ExpenseBot report at an " +
1181
+ "accounting destination. Use after a timeout or uncertain response before considering any " +
1182
+ "retry. This tool is read-only and owner-account only.",
1183
+ inputSchema: {
1184
+ type: "object",
1185
+ properties: {
1186
+ provider: { type: "string", enum: ["zoho_books"] },
1187
+ reportId: { type: "string" },
1188
+ },
1189
+ required: ["provider", "reportId"],
1190
+ },
1191
+ },
1091
1192
  {
1092
1193
  name: "list_categories",
1093
1194
  description:
@@ -2165,6 +2266,17 @@ async function handleTool(name, args) {
2165
2266
  case "add_income_from_csv":
2166
2267
  return formatResult(await client.execute("add_income_from_csv", args));
2167
2268
 
2269
+ case "get_accounting_integration_status":
2270
+ return formatResult(
2271
+ await client.execute("get_accounting_integration_status", args)
2272
+ );
2273
+
2274
+ case "send_report_to_accounting":
2275
+ return formatResult(await client.execute("send_report_to_accounting", args));
2276
+
2277
+ case "get_accounting_push_status":
2278
+ return formatResult(await client.execute("get_accounting_push_status", args));
2279
+
2168
2280
  case "list_categories":
2169
2281
  return formatResult(await client.execute("list_categories", {}));
2170
2282
 
@@ -2560,7 +2672,7 @@ function formatResult(result) {
2560
2672
 
2561
2673
  async function main() {
2562
2674
  const server = new Server(
2563
- { name: "expensebot-auth", version: "0.6.19" },
2675
+ { name: "expensebot-auth", version: "0.6.20" },
2564
2676
  { capabilities: { tools: {} }, instructions: SERVER_INSTRUCTIONS }
2565
2677
  );
2566
2678
 
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 = 51;
26
+ const EXPECTED_TOOL_COUNT = 54;
27
27
  const REQUIRED_TOOLS = [
28
28
  // v0.5.x
29
29
  "search_expenses",
@@ -60,6 +60,10 @@ const REQUIRED_TOOLS = [
60
60
  "get_monthly_books_review",
61
61
  "get_credits_refunds",
62
62
  "get_client_advance_balances",
63
+ // Provider-neutral accounting-agent workflow (Zoho Books first)
64
+ "get_accounting_integration_status",
65
+ "send_report_to_accounting",
66
+ "get_accounting_push_status",
63
67
  ];
64
68
 
65
69
  const REQUESTS = [
@@ -1,10 +0,0 @@
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
- }