TripLedger MCP server
A remote MCP server for your personal travel history. Connect Claude, ChatGPT, Cursor or any MCP client to TripLedger and keep a durable ledger of where you've been: journeys, stays and travel expenses, with tax-residency day counts and Schengen 90/180 status computed from your records.
- Endpoint:
https://my.tripledger.app/mcp(Streamable HTTP) - Auth: OAuth 2.1 (browser consent) or a
tl_API key - Docs: docs.tripledger.app
This repository contains connection instructions and configuration only. TripLedger is a hosted service; nothing here runs locally.
What you can ask
- "Log my flight from this booking email: LHR → BCN on 14 March, back on the 21st."
- "How many Schengen days do I have left if I travel to Lisbon on 2 June?"
- "How many days have I spent in Spain this year, and in the last 365 days?"
- "Where am I according to my travel ledger?"
- "Find gaps in my 2025 travel history before I send it to my accountant."
Connect
Claude.ai / Claude Desktop (OAuth)
- Settings → Connectors → Add custom connector
- Paste
https://my.tripledger.app/mcp - Log in to TripLedger and approve. Each grant binds one ledger.
Claude Code (API key)
Create a key in TripLedger under Settings → API keys (shown once), then:
claude mcp add --transport http tripledger https://my.tripledger.app/mcp \
--header "Authorization: Bearer tl_YOUR_KEY"
Other MCP clients
Clients that support remote OAuth: configs/mcp-oauth.json.
Clients that need a header: configs/mcp-api-key.json.
Treat API keys like passwords. Revoke keys and OAuth grants anytime in TripLedger Settings → API keys / Connected apps.
Tools
Read
| Tool | What it does |
|---|---|
get_profile | Connected ledger and credential scope |
get_tripledger_guide | Operating guide for agents |
get_journey_review | Booked journeys that are now overdue for confirmation |
search_locations | Cities by name or airport code |
list_people | Travelers in the ledger |
list_journeys / get_journey | Journeys (the presence record) |
list_stays / get_stay | Accommodation |
list_expenses | Costs attached to journeys and stays |
list_loyalty_programs / list_loyalty_accounts | Loyalty programs and accounts (numbers masked) |
get_travel_summary | Days per country |
get_residency_status | Days against configured tax-residency thresholds |
check_schengen_status | Rolling Schengen 90/180 status |
get_current_country | Current country from recorded journeys |
detect_journey_gaps | Missing movements that make counts uncertain |
get_methodology | How every count is calculated |
Write
log_journey, update_journey, delete_journey, log_stay, update_stay, delete_stay,
log_expense, update_expense, delete_expense, create_loyalty_account,
update_loyalty_account, delete_loyalty_account, set_journey_preferences.
Live tool schemas from the server are authoritative.
Access and pricing
- 14-day trial, then a one-time $97 lifetime license per ledger. No subscription.
- After a trial ends the ledger is read-only: reads, calculations and MCP read tools keep working.
- 5,000 MCP requests per ledger per day.
- Writes need an owner or editor role; viewers get read tools.
Agent plugin
plugin/ is an Agent Plugins package: the MCP server plus a
managing-tripledger workflow skill that teaches agents to capture travel from evidence, never
invent records, and confirm before deleting.
Not
TripLedger is a ledger, not flight or hotel search, a booking service, or live location tracking. Results depend on the travel you record. They are informational, not tax or legal advice, and not a guarantee of admission at any border.
Links
Website · Docs · Schengen tracking · Tax-residency day counter · Privacy · Terms · [email protected]
Made by Pianosa Labs.