# io.github.theluckystrike/expense-tracker (mcpb · expense-tracker.mcpb)

Log expenses, receipts and mileage from chat: auto-categorise, split VAT, summarise, export, rebill.

- Trust score: 43/100 (low)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-21

## Components

- mcpb · `expense-tracker.mcpb`: 43/100 (this document), [markdown](https://verifymcp.io/servers/theluckystrike-expense-tracker/https-github-com-theluckystrike-mcp-servers-releases-download-v0-22-0-expense-tr.md), [page](https://verifymcp.io/servers/theluckystrike-expense-tracker/https-github-com-theluckystrike-mcp-servers-releases-download-v0-22-0-expense-tr)

## Channel facts

- Registry: `mcpb`
- Package: `https://github.com/theluckystrike/mcp-servers/releases/download/v0.22.0/expense-tracker.mcpb`
- Version: `0.22.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-21.

- **Supply Chain Security**: 13/100
  - Malware scan not yet available for this package.
  - Known CVEs could not be checked: we could not reach the registry to check. This is a gap on our side.
  - No install/post-install scripts declared.
  - Dependency health could not be checked: we could not reach the registry to check. This is a gap on our side.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 3 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 79/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 2389 tokens (~159/item across 15 items; 14 tools + 1 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 91/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 72% of tool parameters carry a description.
- **Tool Safety**: 75/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - 0 of 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "expense_delete" implies "delete" and declares no destructiveHint at all, which the MCP spec reads as destructive by default.
  - An AI judge read all 15 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

- Download bundle: `https://github.com/theluckystrike/mcp-servers/releases/download/v0.22.0/expense-tracker.mcpb`

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-21 (score 43, −3)

- [security regression] Known CVEs: partial → unverified
- [functional regression] Dependency health: 0.80 → unverified

### 2026-09-18 (score 46)

First indexed and scored.

## MCP tools (14)

### `expense_add` (~338 tokens)

Add an expense

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.

Input parameters:

- `amount` (number, required): 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.
- `billable` (boolean): 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.
- `category` (string): Category, e.g. software, travel, office. Omit and the stored category rules are matched against the merchant to fill it in
- `currency` (string): ISO code. Defaults to your expense_settings default_currency, else the shared business profile's default_currency, else EUR
- `date` (string): ISO date YYYY-MM-DD, default today
- `merchant` (string): Who was paid, e.g. Adobe
- `note` (string)
- `project` (string): Project or client this belongs to
- `receipt_path` (string): Absolute path to the receipt file; it is checked and hashed
- `tax_rate` (number): Alias for vat_rate
- `vat` (number): Alias for vat_rate
- `vat_rate` (number): 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

### `expense_list` (~98 tokens)

List expenses

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.

Input parameters:

- `billable` (boolean)
- `category` (string)
- `from` (string): ISO date, inclusive
- `project` (string)
- `to` (string): ISO date, inclusive

### `expense_update` (~194 tokens)

Update an expense

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.

Input parameters:

- `amount` (number)
- `billable` (boolean)
- `category` (string)
- `currency` (string)
- `date` (string)
- `id` (string, required): Expense id from expense_add or expense_list
- `merchant` (string)
- `note` (string)
- `project` (string)
- `rebilled` (boolean): false clears the rebilled marker and the invoice number, so the expense can be billed again
- `unlink_rebill` (boolean): Allow editing amount, currency or vat_rate on a rebilled expense. Clears rebilled_at and rebilled_invoice, because the invoice no longer matches
- `vat_rate` (number)

### `expense_delete` (~55 tokens)

Delete an expense

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.

Input parameters:

- `id` (string, required)

### `receipt_attach` (~99 tokens)

Attach a receipt

Call this tool to attach a receipt file to a stored expense. Returns the stored path and sha256. The file must exist; it is hashed so a later audit can prove the file has not changed.

Input parameters:

- `id` (string, required): Expense id from expense_add or expense_list
- `path` (string, required): Path to the receipt file. It must already exist; a leading ~ is expanded. The path and its sha256 are stored on the expense

### `category_rules` (~82 tokens)

Category rules

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.

Input parameters:

- `rules` (array): The FULL rule list; it replaces the stored one, so include the rules you want to keep. Omit to list the current rules instead

### `expense_settings` (~145 tokens)

Expense defaults

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.

Input parameters:

- `default_currency` (string): ISO 4217 code to assume when a call gives none, e.g. EUR. Default EUR
- `default_vat_rate` (number): 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 expe…

### `expense_summary` (~103 tokens)

Summarise expenses

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.

Input parameters:

- `billable` (boolean)
- `from` (string, required): ISO date, inclusive
- `group_by` (string, required): How to group the totals
- `project` (string)
- `to` (string, required): ISO date, inclusive

### `mileage_add` (~359 tokens)

Add a mileage claim

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.

Input parameters:

- `billable` (boolean): Whether the trip is rebilled to the client. Default true, so a mileage claim reaches expense_to_invoice unless you pass false
- `currency` (string): Currency for your own rate. Only accepted together with rate_per_km; a table rate keeps the table currency
- `date` (string): ISO date, default today
- `km` (number): Distance in kilometres. Give exactly one of km or miles
- `miles` (number): Distance in miles. Give exactly one of km or miles
- `project` (string): 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
- `purpose` (string, required): Why the trip was made, e.g. client meeting in Krakow
- `rate_per_km` (number): Your own rate per supplied unit, overriding the table. Pass it whenever you need your exact scheme rather than the approximate table rate
- `region` (string): 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 d…

### `expense_export` (~136 tokens)

Export expenses

Call this tool to write manually logged receipts to a csv, xlsx or json file. Returns the path. Bank transactions for the period are exported by bank-statement's statement_export tool, not this one.

Input parameters:

- `billable` (boolean)
- `category` (string)
- `format` (string, required)
- `from` (string, required): ISO date, inclusive
- `path` (string): Absolute path to write to; a leading ~ is expanded and missing parent directories are created. Default is an exports folder in the server data directory
- `project` (string)
- `to` (string, required): ISO date, inclusive

### `expense_to_invoice` (~433 tokens)

Rebill expenses to an invoice

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.

Input parameters:

- `assume_vat_rate` (number): 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…
- `from` (string, required): ISO date, inclusive
- `fx_rates` (object): 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 ran…
- `include_rebilled` (boolean): Include expenses already marked as rebilled, default false
- `markup_percent` (number): 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 twi…
- `project` (string, required): Project or client to rebill
- `target_currency` (string): 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 curre…
- `to` (string, required): ISO date, inclusive

### `expense_mark_rebilled` (~200 tokens)

Mark expenses as rebilled

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.

Input parameters:

- `currency` (string): 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
- `from` (string): ISO date, inclusive
- `ids` (array): Expense ids, as returned per currency by expense_to_invoice. Takes precedence over project/from/to
- `invoice_number` (string, required): Invoice the expenses were billed on. Required: the marker records WHICH invoice carries each expense, and it is stored on every expense marked
- `project` (string): Project rebilled, used with from, to and currency
- `to` (string): ISO date, inclusive

### `license_status` (~54 tokens)

License status

Report this server's licence state: product, tier free or pro, licence id, expiry, the key source and the upgrade URL. No arguments, no network. Explains a free-tier refusal; license_activate installs a key.

### `license_activate` (~71 tokens)

Activate license

Activate a Pro key (MCPL1.xxx.yyy) from checkout: verified offline against a built-in public key, saved to your config file. A wrong, malformed or expired key is refused, unsaved. license_status reads it back.

Input parameters:

- `key` (string, required): License key from the checkout confirmation page

## Diagnostics

Captured diagnostic sections: Provenance. The full working is on the page: https://verifymcp.io/servers/theluckystrike-expense-tracker/https-github-com-theluckystrike-mcp-servers-releases-download-v0-22-0-expense-tr#diagnostics

## Score history

- 2026-09-21: 43
- 2026-09-20: 46
- 2026-09-19: 46
- 2026-09-18: 46

## Common questions

### What is the io.github.theluckystrike/expense-tracker MCP server?

io.github.theluckystrike/expense-tracker is an MCP server listed in the public MCP registry as io.github.theluckystrike/expense-tracker. Log expenses, receipts and mileage from chat: auto-categorise, split VAT, summarise, export, rebill. This page covers its MCPB bundle (https://github.com/theluckystrike/mcp-servers/releases/download/v0.22.0/expense-tracker.mcpb).

### Is the io.github.theluckystrike/expense-tracker MCP server safe to use?

io.github.theluckystrike/expense-tracker scores 43 out of 100 on VerifyMCP. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the io.github.theluckystrike/expense-tracker MCP server expose?

io.github.theluckystrike/expense-tracker exposes 14 tools: expense_add, expense_list, expense_update, expense_delete, receipt_attach, and 9 more. Their descriptions and schemas cost roughly 2,367 tokens of context every time the server is loaded.

### What licence is the io.github.theluckystrike/expense-tracker MCP server under?

io.github.theluckystrike/expense-tracker declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- Repository: https://github.com/theluckystrike/mcp-servers
- Website: https://mcp.zovo.one/s/expense-tracker
- Changelog RSS feed: https://verifymcp.io/servers/theluckystrike-expense-tracker/https-github-com-theluckystrike-mcp-servers-releases-download-v0-22-0-expense-tr.xml
- Changelog JSON feed: https://verifymcp.io/servers/theluckystrike-expense-tracker/https-github-com-theluckystrike-mcp-servers-releases-download-v0-22-0-expense-tr.json
- HTML version of this page: https://verifymcp.io/servers/theluckystrike-expense-tracker/https-github-com-theluckystrike-mcp-servers-releases-download-v0-22-0-expense-tr