# Residays

> Residays is a freemium MCP server for legal and government. MCP connector to read your travel days and tax residency results and add planned trips. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Web, API
- **Website:** https://tax.liongkj.com/ai
- **MCP Registry name:** io.github.liongkj/residays
- **Categories:** legal and government, maps and travel
- **Listing updated:** 2026-11-17

## About

Residays tracks where you spend time and how that affects tax residency, and this connector lets an AI app read that record in plain language. The key design point is that day counts and outcomes always come from Residays itself; the assistant quotes them rather than doing its own arithmetic.

Reading covers saved trips, a residency assessment for one country and tax year with each rule test, how many more days fit under a country's day limit and the latest return date, plain-word country rules with official sources, a multi-country overview, what-if trips that save nothing, and a day count report for an accountant. If you allow it when connecting, the app can also add, change or cancel planned trips and, on Premium, create email reminders.

Safeguards are explicit. Added trips are always planned and count only in projections until you confirm them in Residays, confirmed travel can only be changed in the app, and nothing is deleted. The free plan assesses 2 countries, and Premium adds more countries and email reminders. Residays says it is run from Malaysia.

## Features

- **Residency assessment:** Shows days counted, days projected and each rule test for a country and year.
- **Travel window:** Calculates how many more days fit under a country's day test and the latest return date.
- **What-if trips:** Previews how extra trips change a result without saving anything.
- **Year-end day count report:** Produces a year's record for an accountant or filing.
- **Planned-trip changes:** With permission, adds, edits or cancels planned trips for you to confirm.
- **Scoped permissions:** Choose read-only or read and change when connecting, and disconnect at any time.

## Good for

- Check whether a trip to London keeps you under the 183-day threshold
- Find the latest date you can fly home and still be resident
- Prepare a day count report for your accountant
- Add a planned trip from chat and review its effect on your days
- Review every tracked country's residency status for the year

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http residays https://tax.liongkj.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://tax.liongkj.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "residays": {
      "url": "https://tax.liongkj.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "residays": {
      "type": "http",
      "url": "https://tax.liongkj.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "residays": {
      "serverUrl": "https://tax.liongkj.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "residays": {
      "type": "http",
      "url": "https://tax.liongkj.com/mcp"
    }
  }
}
```

## FAQ

### Does the AI calculate my day counts?

No. The counts and outcomes come from Residays and the assistant quotes them.

### Can the connector change my confirmed travel?

No. It can add or change only planned trips, and confirmed travel can be changed only in Residays.

### What does the free plan include?

Tracking and assessing 2 countries; Premium adds more countries and email reminders.

### How do I disconnect?

In Residays, open Settings, Connected AI apps and disconnect the app; access stops at once.

### Is Residays free?

Residays has a free plan, with paid plans for more usage or features.

### How do I add Residays to Claude Code?

Run this command in your terminal: claude mcp add --transport http residays https://tax.liongkj.com/mcp

### What are the best alternatives to Residays?

The closest alternatives to Residays are Tutu eSIM, NY LLC Publication (FileMyPublication), TribuJus, SupplyClub Catalog and SynomosAI Governance MCP.

## Alternatives

- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [SupplyClub Catalog](https://ai-powered.com/mcp/supplyclub-catalog): SupplyClub Catalog is a free MCP server for legal and government.
- [SynomosAI Governance MCP](https://ai-powered.com/mcp/synomosai-governance-mcp-2): SynomosAI Governance MCP is an open-source MCP server for security.
- [Shanghai Streets Travel Guide](https://ai-powered.com/mcp/shanghai-streets-travel-guide): Shanghai Streets Travel Guide is a free MCP server for maps and travel.
- [MedXpert 标准检索连接器](https://ai-powered.com/mcp/medxpert-2): MedXpert 标准检索连接器 is a free MCP server for legal and government.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/residays
