@expensebot/mcp-server-auth 0.5.0 → 0.5.1

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.
Files changed (2) hide show
  1. package/README.md +110 -0
  2. package/package.json +1 -1
package/README.md ADDED
@@ -0,0 +1,110 @@
1
+ # @expensebot/mcp-server-auth
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.
4
+
5
+ **21 tools** across:
6
+ - **Search & analytics** — `search_expenses`, `get_spending_summary`, `get_deep_analytics`, `list_categories`, `list_tags`, `search_knowledge`
7
+ - **Receipt capture** — `submit_receipt` (photo/PDF), `add_cash_expense`, `add_mileage_entry`, `add_income`, `parse_expense`
8
+ - **Gmail** — `scan_gmail`, `process_gmail_receipts`
9
+ - **Reports** — `create_report`, `list_reports`, `get_report_details`, `share_report`
10
+ - **Compliance & tax** — `check_compliance`, `fix_compliance`, `check_tax_deductibility`
11
+ - **Onboarding** — `get_signup_link`
12
+
13
+ ## Setup
14
+
15
+ **Full step-by-step instructions for every supported client live at:**
16
+
17
+ → **<https://www.expensebot.ai/mcp>**
18
+
19
+ ### Quick start (Claude Desktop)
20
+
21
+ 1. Sign in at [expensebot.ai](https://www.expensebot.ai) → Settings → AI Assistant Tokens → Generate
22
+ 2. Copy the token (shown once)
23
+ 3. Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
24
+
25
+ ```json
26
+ {
27
+ "mcpServers": {
28
+ "expensebot": {
29
+ "command": "npx",
30
+ "args": ["-y", "@expensebot/mcp-server-auth", "--token=YOUR_TOKEN_HERE"]
31
+ }
32
+ }
33
+ }
34
+ ```
35
+
36
+ 4. Restart Claude Desktop
37
+
38
+ ### Quick start (Claude Code CLI)
39
+
40
+ ```bash
41
+ claude mcp add expensebot -- npx -y @expensebot/mcp-server-auth --token=YOUR_TOKEN_HERE
42
+ ```
43
+
44
+ ### Quick start (Cursor)
45
+
46
+ Edit `~/.cursor/mcp.json`:
47
+
48
+ ```json
49
+ {
50
+ "mcpServers": {
51
+ "expensebot": {
52
+ "command": "npx",
53
+ "args": ["-y", "@expensebot/mcp-server-auth", "--token=YOUR_TOKEN_HERE"]
54
+ }
55
+ }
56
+ }
57
+ ```
58
+
59
+ Then in Cursor: Settings → Tools & Integrations → confirm the green dot next to **expensebot**.
60
+
61
+ ### Continue, Cline, Windsurf, custom clients
62
+
63
+ Same `npx -y @expensebot/mcp-server-auth --token=...` command in your client's MCP config.
64
+
65
+ ## Token model
66
+
67
+ - **Personal Access Tokens (PAT)** scoped to your ExpenseBot account
68
+ - **Configurable expiry**, revokable instantly from Settings → AI Assistant Tokens
69
+ - **Max 5 active tokens per user** — generate one per device/AI client
70
+ - All actions audit-logged server-side
71
+ - Tokens stored as SHA-256 hashes; CASA Tier 2 certified
72
+
73
+ ## Listed on
74
+
75
+ - **Official MCP Registry** — `io.github.TotesMagotes/mcp-server-auth`
76
+ - **awesome-mcp-servers** — Finance & Fintech section
77
+ - **Glama** — <https://glama.ai/mcp/servers/TotesMagotes/expensebot>
78
+
79
+ ## Onboarding mode (no token)
80
+
81
+ Running without a token exposes 2 read-only tools that help new users sign up:
82
+ - `get_signup_link` — returns ExpenseBot signup URL
83
+ - `search_knowledge` — searches the public ExpenseBot knowledge base
84
+
85
+ ```bash
86
+ npx @expensebot/mcp-server-auth
87
+ # (no --token argument)
88
+ ```
89
+
90
+ Useful for AI agents evaluating ExpenseBot before a user has an account.
91
+
92
+ ## Read-only docs server
93
+
94
+ For pure pre-sales discovery (no account, no token):
95
+
96
+ ```bash
97
+ npx @expensebot/mcp-server
98
+ ```
99
+
100
+ Exposes the ExpenseBot knowledge base, FAQ, and feature docs as MCP resources. Useful for AI agents answering "does ExpenseBot support X?" type questions.
101
+
102
+ ## Source / issues / support
103
+
104
+ - Source: <https://github.com/TotesMagotes/expensebot/tree/master/mcp-server-auth>
105
+ - Issues: email `support@expensebot.ai`
106
+ - Roadmap (remote HTTPS MCP for ChatGPT + Claude.ai web): <https://www.expensebot.ai/mcp>
107
+
108
+ ## License
109
+
110
+ MIT
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@expensebot/mcp-server-auth",
3
- "version": "0.5.0",
3
+ "version": "0.5.1",
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": {