Serveur MCP

mileage-log

io.github.theluckystrike/mileage-log

Ce que fait ce MCP

Logs business and other deductible driving, applies effective-dated mileage rates, summarizes deductions, and exports records as CSV.

license_activate
Activate license
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.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['key'], 'properties': {'key': {'type': 'string', 'description': 'License key from checkout, MCPL1.<payload>.<signature>'}}, 'additionalProperties': False}
license_status
License status
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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
mileage_export
Export the log as CSV for an accountant
The mileage log as CSV, one row per trip, oldest first: date, from, to, distance, unit, category, the rate applied (the one in force on the trip's day), the currency and the amount, plus purpose, jurisdiction, effective_from and id. The amount column is a bare number a spreadsheet reads. Refuses while any non-personal trip in the window is unpriced, so an accountant never receives a log with silent gaps. Pro.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to_date': {'type': 'string', 'maxLength': 10, 'description': 'End of the range, YYYY-MM-DD. Default December 31 of the current year'}, 'from_date': {'type': 'string', 'maxLength': 10, 'description': 'Start of the range, YYYY-MM-DD. Default January 1 of the current year'}}, 'additionalProperties': False}
mileage_summary
Summarize a date range
The deductible mileage for a date range, per category: trips, distance kept per unit, the rate each trip earned (the one in force on its day), and the deductible amount, totalled per currency. Trips with no applicable rate are listed with the reason, not silently dropped. Defaults to the current calendar year. Never metered.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to_date': {'type': 'string', 'maxLength': 10, 'description': 'End of the range, YYYY-MM-DD. Default December 31 of the current year'}, 'category': {'type': 'string', 'maxLength': 20, 'description': 'Only this category: business, medical, moving, charitable, personal'}, 'from_date': {'type': 'string', 'maxLength': 10, 'description': 'Start of the range, YYYY-MM-DD. Default January 1 of the current year'}}, 'additionalProperties': False}
rate_list
List the rates on file
List every mileage rate on file, grouped by jurisdiction and category with the effective-from dates in order: the series each trip is priced from. Reads only.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
rate_set
Set a mileage rate
Set what one mile or km is worth for one category in one jurisdiction from a date forward: the jurisdiction label, the category, the rate per unit, the currency, and the date it takes effect. Rates form a series per jurisdiction and category, and each trip earns the rate in force on the day it was driven. No rate ships with this server; the figures are yours to verify. Free tier: one rate per jurisdiction and category; the year-over-year series is Pro.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['jurisdiction', 'category', 'rate', 'unit', 'currency', 'effective_from'], 'properties': {'rate': {'type': 'number', 'description': 'The rate per unit in currency units, to the thousandth, e.g. 0.70 for 70 cents a mile', 'exclusiveMinimum': 0}, 'unit': {'type': 'string', 'maxLength': 20, 'description': 'The distance unit the rate prices'}, 'category': {'type': 'string', 'maxLength': 20, 'description': 'Which category this prices: business, medical, moving, charitable, personal'}, 'currency': {'type': 'string', 'pattern': '^[A-Za-z]{3}$', 'description': 'ISO code the rate is in'}, 'jurisdiction': {'type': 'string', 'maxLength': 100, 'description': 'A label for the rate set, e.g. US federal or Canada federal. It is a label, not legal advice'}, 'effective_from': {'type': 'string', 'maxLength': 10, 'description': "The date the rate starts to apply, YYYY-MM-DD. May be in the future: authorities announce next year's rate ahead of time"}}, 'additionalProperties': False}
trip_add
Log a trip
Log one drive in the mileage log: the date, where from and to, the distance in miles or km, the purpose, and the category (business, medical, moving, charitable, personal). Returns its TR-YYYY-NNNN id. Free tier: 20 trips per calendar month, counted on the month of the trip date.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['date', 'from', 'to', 'distance', 'unit', 'purpose', 'category'], 'properties': {'to': {'type': 'string', 'maxLength': 200, 'description': 'Where it ended, e.g. Client site, 2 Mill Lane'}, 'date': {'type': 'string', 'maxLength': 10, 'description': 'The day the trip was driven, YYYY-MM-DD. A future date is refused: the trip cannot have been driven yet'}, 'from': {'type': 'string', 'maxLength': 200, 'description': 'Where the trip started, e.g. Home office, 14 Nowa Street'}, 'note': {'type': 'string', 'maxLength': 2000}, 'unit': {'type': 'string', 'maxLength': 20, 'description': 'miles or km; spellings like mi and kilometre are accepted'}, 'purpose': {'type': 'string', 'maxLength': 200, 'description': 'Why the trip was made, e.g. Site visit for the Kowalski refit'}, 'category': {'type': 'string', 'maxLength': 20, 'description': 'One of: business, medical, moving, charitable, personal. Personal trips are kept for the record and priced only if a rate exists'}, 'distance': {'type': 'number', 'description': 'How far, to the thousandth of the unit, e.g. 12.5', 'exclusiveMinimum': 0}, 'jurisdiction': {'type': 'string', 'maxLength': 100, 'description': 'Which rate set prices this trip, when more than one jurisdiction has a rate for its category. Omit when only one does'}}, 'additionalProperties': False}
trip_list
List trips
List trips in the mileage log, oldest first: date, from, to, distance, category, and the amount each earns under the rate in force on its day (or the plain reason it is unpriced). Filter by date range and category. Reads only.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to_date': {'type': 'string', 'maxLength': 10, 'description': 'Only trips dated on or before this, YYYY-MM-DD'}, 'category': {'type': 'string', 'maxLength': 20, 'description': 'Only trips of this category: business, medical, moving, charitable, personal'}, 'from_date': {'type': 'string', 'maxLength': 10, 'description': 'Only trips dated on or after this, YYYY-MM-DD'}}, 'additionalProperties': False}
trip_remove
Remove a trip
Remove one trip from the mileage log by its exact TR-YYYY-NNNN id, for entries made by mistake. The id is not reissued: a gap in the TR series is the record that a trip was removed.
Destructif
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'maxLength': 20, 'description': 'The exact trip id, e.g. TR-2026-0003'}}, 'additionalProperties': False}
Modifié
license_activate
22 September 2026 02:40
Modifié
license_status
22 September 2026 02:40
Modifié
mileage_export
22 September 2026 02:40
Modifié
mileage_summary
22 September 2026 02:40
Modifié
rate_list
22 September 2026 02:40
Modifié
rate_set
22 September 2026 02:40
Modifié
trip_remove
22 September 2026 02:40
Modifié
trip_list
22 September 2026 02:40
Modifié
trip_add
22 September 2026 02:40
Ajouté
license_activate
18 September 2026 02:40
Ajouté
license_status
18 September 2026 02:40
Ajouté
mileage_export
18 September 2026 02:40
Ajouté
mileage_summary
18 September 2026 02:40
Ajouté
rate_list
18 September 2026 02:40
Ajouté
rate_set
18 September 2026 02:40
Ajouté
trip_remove
18 September 2026 02:40
Ajouté
trip_list
18 September 2026 02:40
Ajouté
trip_add
18 September 2026 02:40