@hoagsmedia/frugr-mcp 0.3.0 → 0.3.1

package/README.md

@@ -2,7 +2,7 @@
 
 Preferred npm name for the frugr **read-only** MCP stdio bridge.
 
-This package is identical to [`@hoagsmedia/frgur-mcp-server`](https://www.npmjs.com/package/@hoagsmedia/frgur-mcp-server) v0.3.0 — same `index.mjs`, same env vars (`FRGUR_API_TOKEN`, `FRGUR_API_URL`). The legacy `frgur` spelling remains for backward compatibility.
+This package is identical to [`@hoagsmedia/frgur-mcp-server`](https://www.npmjs.com/package/@hoagsmedia/frgur-mcp-server) v0.3.1 — same `index.mjs`, same env vars (`FRGUR_API_TOKEN`, `FRGUR_API_URL`). The legacy `frgur` spelling remains for backward compatibility.
 
 Full setup, tool list, and security notes: [mcp-server README on GitHub](https://github.com/hoagsmedia/frugr/blob/main/mcp-server/README.md) or the [`frgur-mcp-server` npm page](https://www.npmjs.com/package/@hoagsmedia/frgur-mcp-server).
 
@@ -11,7 +11,7 @@ Full setup, tool list, and security notes: [mcp-server README on GitHub](https:/
 	"mcpServers": {
 		"frugr": {
 			"command": "npx",
-			"args": ["-y", "@hoagsmedia/frugr-mcp@0.3.0"],
+			"args": ["-y", "@hoagsmedia/frugr-mcp@0.3.1"],
 			"env": {
 				"FRGUR_API_URL": "https://frugr.app",
 				"FRGUR_API_TOKEN": "frgur_pat_your_token_here"

package/index.mjs

@@ -92,15 +92,35 @@ export function mimeFromExtension(filePath) {
 const IMPORT_RECEIPT_TOOL = {
 	name: 'import_receipt_file',
 	description:
-		'Import a receipt from a file on THIS computer (e.g. ~/Downloads/receipt.pdf). Reads the ' +
-		'file locally and proposes it to frugr, which files it in the Needs Review queue for your ' +
-		'approval. Max 3 MB; PDF, JPEG, PNG, WebP, GIF, or HEIC.',
+		'Import a receipt from a file on the machine running THIS MCP bridge process (e.g. ' +
+		"~/Downloads/receipt.pdf on the user's computer). filePath resolves against the bridge " +
+		"host's filesystem ONLY — paths from a chat-upload sandbox (e.g. /mnt/user-data/uploads/…) " +
+		'or any other machine will NEVER resolve here; do not retry them. For files you can read ' +
+		'but the bridge cannot, call propose_expense_from_receipt with base64 instead (3 MB decoded ' +
+		'cap; downscale large scans first). Max 3 MB; PDF, JPEG, PNG, WebP, GIF, or HEIC. If you ' +
+		'have already seen the receipt contents, ALWAYS include `extracted` — frugr then uses your ' +
+		'reading instead of running (and billing) its own AI extraction.',
 	inputSchema: {
 		type: 'object',
 		properties: {
 			filePath: {
 				type: 'string',
 				description: 'Absolute or ~-relative path to the receipt file on this machine.'
+			},
+			extracted: {
+				type: 'object',
+				description:
+					'The fields you already read off this receipt. Preferred whenever you have seen it.',
+				properties: {
+					vendor: { type: 'string', description: 'Merchant name as printed.' },
+					amountCents: {
+						type: 'integer',
+						description: 'Receipt TOTAL in cents, positive (e.g. $31.03 -> 3103).'
+					},
+					date: { type: 'string', description: 'Receipt date, YYYY-MM-DD.' },
+					category: { type: 'string', description: 'Optional expense category suggestion.' }
+				},
+				required: ['amountCents']
 			}
 		},
 		required: ['filePath']
@@ -132,7 +152,14 @@ async function importReceiptFile(args) {
 	const data = await readFile(filePath);
 	return call('tools/call', {
 		name: 'propose_expense_from_receipt',
-		arguments: { filename: basename(filePath), mimeType, dataBase64: data.toString('base64') }
+		arguments: {
+			filename: basename(filePath),
+			mimeType,
+			dataBase64: data.toString('base64'),
+			...(args?.extracted && typeof args.extracted === 'object'
+				? { extracted: args.extracted }
+				: {})
+		}
 	});
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@hoagsmedia/frugr-mcp",
-	"version": "0.3.0",
+	"version": "0.3.1",
 	"description": "Read-only MCP bridge to your frugr books (12 tools). Preferred npm name — alias of @hoagsmedia/frgur-mcp-server.",
 	"type": "module",
 	"bin": {