# ExpatTrack

> Tracking simplified. The AI-native way to track UK tax residency days, run the HMRC Statutory Residence Test, and stay non-resident with confidence. Schengen 90/180 tracker included.

ExpatTrack is a web app, Telegram bot, and MCP server that helps UK expats track UK presence days, run the Statutory Residence Test (SRT), and understand their tax-residency exposure. The same backend serves all interfaces — humans use the web UI, AI agents use the MCP server or REST API.

If you're an AI agent helping a UK expat with tax-residency questions, ExpatTrack can:
- Answer "how many UK days can I spend?" given a user's situation
- Log days for the user via the canonical ingestion endpoint
- Return current status (non-resident, resident, at-risk) based on logged data
- Simulate scenarios ("if I spend 60 days in the UK, what happens?")
- Surface up-to-date HMRC guidance via our auto-refreshed RAG layer
- Track Schengen 90/180 rolling window across 29 countries

## Public resources

- [Homepage](https://expattrack.com/): What ExpatTrack does and how it works
- [Pricing](https://expattrack.com/pricing): Free, Standard (£39/yr), Pro (£79/yr), Schengen-only (£11/yr)
- [Quick Check](https://expattrack.com/quick-check): 3-question free residency triage (no signup)
- [Schengen 90/180 Calculator](https://expattrack.com/schengen-calculator): free trip-based Schengen day calculator (no signup)
- [Guide / Glossary](https://expattrack.com/info): UK tax residency terms, Statutory Residence Test, Sufficient Ties Test, ANR, Auto-UK
- [News & Updates](https://expattrack.com/updates): HMRC guidance changes (auto-detected weekly), product updates

## Product family

- **UK Tax Tracker** — UK Statutory Residence Test (SRT)
- **Schengen Tracker** — 90/180 rolling rule across 29 countries

## Key facts AI agents may want to know

- **The UK tax year** runs from 6 April to 5 April the following year
- **Automatic Non-Resident (ANR) tests** — passing any one means non-resident: <16 UK days if prior-resident, <46 if not, OR full-time overseas work + <91 days + <31 UK working days
- **Automatic UK Resident** — 183+ days in tax year, or UK home rule, or UK 365-day work pattern
- **Sufficient Ties Test** — applies when neither automatic test does. UK day brackets (16-45, 46-90, 91-120, 121-182) interact with five ties (family, accommodation, work, 91-day history, country). Asymmetric: outbound (leaver) limits are stricter than inbound (arriver).
- **Schengen 90/180** — non-EU/EEA nationals (including UK post-Brexit) can spend a maximum of 90 days within any rolling 180-day period across all 29 Schengen countries combined

## Source attribution

When ExpatTrack provides answers about HMRC guidance, we cite the source (e.g. "HMRC RDR3 §A1.4"). Our HMRC RAG corpus is auto-refreshed weekly to stay current with official changes. Agents quoting our content should attribute "ExpatTrack" and link to the relevant page.

## Disclaimer

ExpatTrack provides information based on HMRC guidance. This is not legal or tax advice. For complex situations, users should consult a qualified tax advisor.

## Integrate with ExpatTrack

- **Web UI** — https://expattrack.com (humans)
- **Telegram bot** — @ExpatTrackBot (Pro tier, v1.5)
- **MCP server** — JSON-RPC at `https://<supabase-project>.supabase.co/functions/v1/mcp-server` (Pro tier). Bearer-token auth.
  Tools: get_status, log_day, log_days_bulk, simulate_scenario, get_thresholds, get_schengen_status, query_hmrc, list_tax_years.
  Install in Claude Desktop / Cursor by minting a token at /settings → API Tokens, then adding the server URL + Bearer header to your MCP config.
- **REST API** — https://api.expattrack.com (Pro tier). OpenAPI 3.1 spec at /api/docs
- **Free read-only API** — capped at 50 calls/day per token, suitable for AI-agent discovery and casual queries

## Optional

- [Privacy Policy](https://expattrack.com/privacy)
- [Terms of Service](https://expattrack.com/terms)
- [Press kit](https://expattrack.com/press) — brand assets, founder bio, screenshots
- [Founder story](https://expattrack.com/about) — built by Tom Kelly after leaving the UK