English Français العربية

TripLedger

السجل الرسمي المالية والمدفوعات

Travel ledger for AI: journeys, stays, expenses, tax-residency day counts and Schengen 90/180.

الشيفرة المصدرية الموقع التوثيق

ماذا يمكنك أن تفعل مع TripLedger؟

  • "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."

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http tripledger 'https://my.tripledger.app/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "tripledger": {
            "type": "http",
            "url": "https://my.tripledger.app/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. TripLedger MCP server
  2. What you can ask
  3. Connect
  4. Tools
  5. Access and pricing
  6. Agent plugin
  7. Not
  8. Links

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)
  1. Settings → Connectors → Add custom connector
  2. Paste https://my.tripledger.app/mcp
  3. 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

ToolWhat it does
get_profileConnected ledger and credential scope
get_tripledger_guideOperating guide for agents
get_journey_reviewBooked journeys that are now overdue for confirmation
search_locationsCities by name or airport code
list_peopleTravelers in the ledger
list_journeys / get_journeyJourneys (the presence record)
list_stays / get_stayAccommodation
list_expensesCosts attached to journeys and stays
list_loyalty_programs / list_loyalty_accountsLoyalty programs and accounts (numbers masked)
get_travel_summaryDays per country
get_residency_statusDays against configured tax-residency thresholds
check_schengen_statusRolling Schengen 90/180 status
get_current_countryCurrent country from recorded journeys
detect_journey_gapsMissing movements that make counts uncertain
get_methodologyHow 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.

Website · Docs · Schengen tracking · Tax-residency day counter · Privacy · Terms · support@tripledger.app

Made by Pianosa Labs.

الأسئلة الشائعة

ما هو TripLedger؟

Travel ledger for AI: journeys, stays, expenses, tax-residency day counts and Schengen 90/180.

كيف أثبّت TripLedger؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http tripledger 'https://my.tripledger.app/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج TripLedger إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل TripLedger مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون TripLedger؟

ينشره pianosa-labs. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.