@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 +12 -5
- package/package.json +6 -2
- package/src/client.js +1 -1
- package/src/index.js +38 -1
- package/src/test.js +2 -1
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
|
|
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
|
-
**
|
|
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
|
-
##
|
|
111
|
+
## Discovery
|
|
107
112
|
|
|
108
|
-
- **Official MCP Registry** —
|
|
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.
|
|
3
|
+
"version": "0.6.18",
|
|
4
4
|
"mcpName": "io.github.TotesMagotes/mcp-server-auth",
|
|
5
|
-
"description": "
|
|
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.
|
|
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.
|
|
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 =
|
|
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 = [
|