{"name":"io.github.theluckystrike/expense-tracker-receipts-mileage","slug":"theluckystrike-expense-tracker-receipts-mileage","title":null,"description":"Log expenses, receipts and mileage from chat: auto-categorise, split VAT, summarise, export, rebill.","url":"https://mcp.market/server/theluckystrike-expense-tracker-receipts-mileage","rating":null,"grade":"A","score":88,"certified":false,"status":"active","category":"other","tags":[],"presence":{"score":23,"stars":0,"forks":0,"downloads_week":null,"last_push_at":"2026-09-19T07:17:48.000Z","license":"MIT"},"uptime":{"percent":100,"checks":3,"ok":3,"last_checked_at":"2026-09-20T07:00:56.229Z","last_ok_at":"2026-09-20T07:00:56.229Z","latency_ms":23},"claimed":false,"transport":"mixed","callable_via_gateway":true,"default_price_micros":0,"repository":"https://github.com/theluckystrike/mcp-servers","website":"https://mcp.zovo.one/s/expense-tracker","version":"0.22.0","remotes":[{"type":"streamable-http","url":"https://mcp.zovo.one/mcp/expense-tracker","headers":[{"description":"Bearer <Pro license key or anonymous token from GET https://mcp.zovo.one/mcp/token>","isRequired":true,"isSecret":true,"name":"Authorization"}]}],"packages":[{"registryType":"mcpb","identifier":"https://github.com/theluckystrike/mcp-servers/releases/download/v0.22.0/expense-tracker.mcpb","version":"0.22.0","fileSha256":"ac1e73efcd39fad676fa8165f559849433bb9464e00a264d9cd44db68c2de111","transport":{"type":"stdio"},"environmentVariables":[{"description":"Optional Pro license key (MCPL1....). Verified offline.","isSecret":true,"name":"MCP_LICENSE_KEY"}]}],"tools":[{"name":"category_rules","description":"Replace the merchant-to-category rules, or call with no rules to list them. Returns the stored rule list. The rules are applied by expense_add whenever a call gives no category of its own.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"rules":{"type":"array","items":{"type":"object","properties":{"match":{"type":"string","maxLength":200,"description":"Matched against the merchant as a case-insensitive regular expression, and as a plain substring if it is not valid regex. The first matching rule in the list wins"},"category":{"type":"string","maxLength":500,"description":"Category to apply"}},"required":["match","category"],"additionalProperties":false},"maxItems":500,"description":"The FULL rule list; it replaces the stored one, so include the rules you want to keep. Omit to list the current rules instead"}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"expense_add","description":"Record one expense and return its id, its net/VAT split and its billable flag. The response states every default that was applied, so the caller can see what was assumed rather than having to guess.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"amount":{"type":"number","description":"Gross amount on the receipt, in major units, e.g. 12.34. It is stored as integer minor units in the expense's own currency, so nothing is lost to floating point."},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$","description":"ISO code. Defaults to your expense_settings default_currency, else the shared business profile's default_currency, else EUR"},"category":{"type":"string","maxLength":500,"description":"Category, e.g. software, travel, office. Omit and the stored category rules are matched against the merchant to fill it in"},"merchant":{"type":"string","maxLength":500,"description":"Who was paid, e.g. Adobe"},"date":{"type":"string","maxLength":10,"description":"ISO date YYYY-MM-DD, default today"},"project":{"type":"string","maxLength":500,"description":"Project or client this belongs to"},"note":{"type":"string","maxLength":2000},"receipt_path":{"type":"string","maxLength":4096,"description":"Absolute path to the receipt file; it is checked and hashed"},"billable":{"type":"boolean","description":"Rebillable to the client. Default: true when project is given (a receipt booked to a client project is normally rebilled), false otherwise. Pass it explicitly to override."},"vat_rate":{"type":"number","minimum":0,"maximum":100,"description":"VAT percent already included in amount; it splits the gross into net and VAT. Omit to use the expense_settings default, or get no split at all when none is set"},"tax_rate":{"type":"number","minimum":0,"maximum":100,"description":"Alias for vat_rate"},"vat":{"type":"number","minimum":0,"maximum":100,"description":"Alias for vat_rate"}},"required":["amount"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"expense_delete","description":"Delete one expense by id and report what went. The receipt FILE stays on disk. Deleting a rebilled expense loses the record of what an invoice charged, so correct it with expense_update instead.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"id":{"type":"string","maxLength":64}},"required":["id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"expense_export","description":"Export the expenses in a date range as csv, xlsx or json and return a download link that is valid for one hour. Nothing partial is ever written: if a limit is hit no file is produced at all.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"from":{"type":"string","maxLength":10,"description":"ISO date, inclusive"},"to":{"type":"string","maxLength":10,"description":"ISO date, inclusive"},"format":{"type":"string","enum":["csv","xlsx","json"]},"path":{"type":"string","maxLength":4096,"description":"Optional file name for the download, e.g. q3.csv"},"project":{"type":"string","maxLength":500},"category":{"type":"string","maxLength":500},"billable":{"type":"boolean"}},"required":["from","to","format"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"expense_list","description":"List expenses in a date range with each one's net/VAT split, category, merchant, project and billable flag, plus a total per currency. Free reads the last 30 days and says when your range predates it.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"from":{"type":"string","maxLength":10,"description":"ISO date, inclusive"},"to":{"type":"string","maxLength":10,"description":"ISO date, inclusive"},"project":{"type":"string","maxLength":500},"category":{"type":"string","maxLength":500},"billable":{"type":"boolean"}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"expense_mark_rebilled","description":"Mark expenses as rebilled once the invoice that carries them actually exists. Pass the expense_ids of one currency group from expense_to_invoice, or that project, date range and currency. Returns what was marked.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string","maxLength":64},"description":"Expense ids, as returned per currency by expense_to_invoice. Takes precedence over project/from/to"},"project":{"type":"string","maxLength":500,"description":"Project rebilled, used with from, to and currency"},"from":{"type":"string","maxLength":10,"description":"ISO date, inclusive"},"to":{"type":"string","maxLength":10,"description":"ISO date, inclusive"},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$","description":"Required when marking by range: one invoice carries one currency. A range marks only billable, not-yet-rebilled expenses in this one currency, so invoicing the EUR group cannot mark the PLN one"},"invoice_number":{"type":"string","maxLength":64,"description":"Invoice the expenses were billed on. Required: the marker records WHICH invoice carries each expense, and it is stored on every expense marked"}},"required":["invoice_number"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"expense_settings","description":"Read or set the defaults expense_add uses when a call does not name them: default_vat_rate and default_currency. Returns the stored defaults. Call with no arguments to read them without changing anything.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"default_vat_rate":{"type":"number","minimum":0,"maximum":100,"description":"VAT percent already included in a receipt, e.g. 23 in Poland, 19 in Germany. Set it once and every later expense gets its net/VAT split without the caller repeating the rate. It applies when the expense is inserted, never retroactively. Pass 0 to clear it"},"default_currency":{"type":"string","pattern":"^[A-Za-z]{3}$","description":"ISO 4217 code to assume when a call gives none, e.g. EUR. Default EUR"}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"expense_summary","description":"Totals for a date range grouped by category, project, month or merchant, per currency with gross, net and VAT, never mixed. Receipts only; bank transactions are totalled by bank-statement's statement_summary.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"from":{"type":"string","maxLength":10,"description":"ISO date, inclusive"},"to":{"type":"string","maxLength":10,"description":"ISO date, inclusive"},"group_by":{"type":"string","enum":["category","project","month","merchant"],"description":"How to group the totals"},"project":{"type":"string","maxLength":500},"billable":{"type":"boolean"}},"required":["from","to","group_by"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"expense_to_invoice","description":"Preview the unbilled billable expenses of one project as invoice_create line items (description, quantity, unit_price, tax_rate), grouped per currency. Read-only: nothing is marked rebilled here.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"project":{"type":"string","maxLength":500,"description":"Project or client to rebill"},"from":{"type":"string","maxLength":10,"description":"ISO date, inclusive"},"to":{"type":"string","maxLength":10,"description":"ISO date, inclusive"},"markup_percent":{"type":"number","minimum":0,"maximum":1000,"description":"Percent added to each net amount. Every line's unit_price is the NET amount and its tax_rate is the VAT rate recorded on the expense, so the invoice recomputes the same tax instead of charging it twice and the line total comes back to the receipt gross"},"include_rebilled":{"type":"boolean","description":"Include expenses already marked as rebilled, default false"},"assume_vat_rate":{"type":"number","minimum":0,"maximum":100,"description":"Split expenses that recorded NO VAT rate at this percent, flagged in the description. Only applied when you pass it here. An expense with no rate holds a GROSS amount and is otherwise rebilled as-is with tax_rate 0 plus a warning in its description, so a default tax rate applied on the invoice would tax that receipt a second time. A stored rate of 0 is a real rate (exempt), not a gap. The expense_settings default is never applied retroactively, because that would rewrite the tax meaning of receipts entered before it existed"},"target_currency":{"type":"string","pattern":"^[A-Za-z]{3}$","description":"Convert every line into this currency and return ONE group, e.g. \"USD\". Needs fx_rates for each other currency present. Lines are otherwise grouped per currency, because one invoice carries one currency; each converted line carries \"[converted from EUR 12.40 at 1.08]\" in its description"},"fx_rates":{"type":"object","additionalProperties":{"type":"number","exclusiveMinimum":0},"description":"Rate per source currency, meaning 1 unit of that currency = X units of target_currency, e.g. {\"EUR\": 1.08, \"GBP\": 1.27}. You supply the rate; nothing here fetches or guesses one. Omit it when the range holds several currencies and the response names the exact argument to pass"}},"required":["project","from","to"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"expense_update","description":"Change one expense by id; only the fields you pass move. amount is in MAJOR units. A rebilled expense refuses an amount, currency or vat_rate edit unless unlink_rebill drops the invoice link.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"id":{"type":"string","maxLength":64,"description":"Expense id from expense_add or expense_list"},"amount":{"type":"number"},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"},"category":{"type":"string","maxLength":500},"merchant":{"type":"string","maxLength":500},"date":{"type":"string","maxLength":10},"project":{"type":"string","maxLength":500},"note":{"type":"string","maxLength":2000},"billable":{"type":"boolean"},"vat_rate":{"type":"number","minimum":0,"maximum":100},"rebilled":{"type":"boolean","description":"false clears the rebilled marker and the invoice number, so the expense can be billed again"},"unlink_rebill":{"type":"boolean","description":"Allow editing amount, currency or vat_rate on a rebilled expense. Clears rebilled_at and rebilled_invoice, because the invoice no longer matches"}},"required":["id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"license_activate","description":"Turn Pro on for this connection with key, an MCPL1.<payload>.<signature> issued at checkout for this server or the bundle. Data under your token stays; a wrong or expired key changes nothing. license_status confirms it.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"key":{"type":"string","description":"License key from checkout, MCPL1.<payload>.<signature>"}},"required":["key"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"license_status","description":"Report this endpoint's licence state for your token as JSON: the product, the tier free or pro, why it is not Pro, and the checkout URL. Call it to explain a free-tier refusal. No arguments, nothing changes.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"mileage_add","description":"Record a business trip as an expense, priced as distance x rate. Give exactly one of km or miles. Returns the saved id with the rate used, where that rate came from and the money, in the rate's own currency.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"km":{"type":"number","description":"Distance in kilometres. Give exactly one of km or miles"},"miles":{"type":"number","description":"Distance in miles. Give exactly one of km or miles"},"date":{"type":"string","description":"ISO date, default today"},"purpose":{"type":"string","maxLength":2000,"description":"Why the trip was made, e.g. client meeting in Krakow"},"project":{"type":"string","maxLength":500,"description":"Bill the trip to a client or project - use the same name you use in time-tracker and expense_add. Without it the drive is invisible to expense_summary by project and to expense_to_invoice"},"region":{"type":"string","enum":["PL","UK","US","EU"],"description":"Which built-in table rate to use: PL 1.15 PLN/km, UK 0.45 GBP/mile, US 0.70 USD/mile, EU 0.30 EUR/km. Default US for miles, EU for km. Each is one flat approximate rate per region with no effective dates, no vehicle or engine class and no first-10000-mile band, so it is NOT a tax calculation"},"rate_per_km":{"type":"number","minimum":0,"description":"Your own rate per supplied unit, overriding the table. Pass it whenever you need your exact scheme rather than the approximate table rate"},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$","description":"Currency for your own rate. Only accepted together with rate_per_km; a table rate keeps the table currency"},"billable":{"type":"boolean","description":"Whether the trip is rebilled to the client. Default true, so a mileage claim reaches expense_to_invoice unless you pass false"}},"required":["purpose"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"receipt_attach","description":"Not available on the hosted endpoint: it has no filesystem, so there is no receipt file to read or hash. Attach receipts on a local install instead - download expense-tracker.mcpb from https://github.com/theluckystrike/mcp-servers/releases/latest and open it in Claude Desktop - or record the receipt reference in the expense note.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"id":{"type":"string","maxLength":64,"description":"Expense id from expense_add or expense_list"},"path":{"type":"string","maxLength":4096,"description":"Path to the receipt file. It must already exist; a leading ~ is expanded. The path and its sha256 are stored on the expense"}},"required":["id","path"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}],"scan":{"score":88,"grade":"A","scanned_at":"2026-09-19T19:21:40.372Z","report":{"scannerVersion":"0.1.5","scannedAt":"2026-09-19T19:21:40.345Z","components":{"code":{"score":-1,"max":25,"notes":["package could not be scanned"]},"reliability":{"score":20,"max":20,"notes":["remote reachable in 246ms"]},"poisoning":{"score":15,"max":15,"notes":["14 tool descriptions checked"]},"auth":{"score":8,"max":15,"notes":["API key sent as a header"]},"maintenance":{"score":15,"max":15,"notes":["last push 1 days ago"]},"identity":{"score":8,"max":10,"notes":["registry namespace matches repository owner","GitHub account older than a year"]}},"findings":[],"inputs":{"probes":[{"url":"https://mcp.zovo.one/mcp/expense-tracker","reachable":true,"authRequired":false,"latencyMs":246,"serverInfo":{"name":"mcp-expense-tracker","version":"0.22.0"}}],"packages":[],"repo":{"found":true,"owner":"theluckystrike","repo":"mcp-servers","archived":false,"pushedAt":"2026-09-19T07:17:48Z","stars":0,"forks":0,"openIssues":0,"ownerType":"User","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/51033404?v=4","ownerCreatedAt":"2019-05-25T20:35:39Z","license":"MIT"},"icon":{"url":"https://mcp.zovo.one/favicon.ico","source":"registry"},"presence":{"stars":0,"forks":0,"downloadsWeek":null,"license":"MIT","lastPushAt":"2026-09-19T07:17:48.000Z","score":23}}}},"grade_history":[{"kind":"restore","fromGrade":"C","toGrade":"A","reason":"score 88","createdAt":"2026-09-19T00:28:32.982Z"}],"reviews":[]}