Departi MCP Server

Travel compliance and trip planning for digital nomads and long-term travelers.

Departi helps you navigate the legal complexity of living abroad — visa requirements for any nationality/destination pair, tax residency analysis across 49 countries, Schengen 90/180-day tracking, and curated accommodation, transport, and experience search across 189 European destinations.

Endpoint

https://mcp.departi.eu/v3

Protocol: Streamable HTTP (JSON-RPC 2.0) Authentication: OAuth 2.1 with PKCE (S256) or anonymous access

Tools

All 7 tools are read-only with full MCP tool annotations.

Compliance

Tool	Description
departi_check_visa	Visa requirements for any nationality/destination pair. Visa type, maximum stay, required documents, digital nomad visa availability. Covers 406 origin countries across 42 European destinations.
departi_check_tax	Tax residency analysis — income tax rates, treaty applicability, social security obligations, FEIE eligibility (US citizens), and filing requirements. 49 countries with full fiscal profiles.
departi_track_schengen	Real-time 90/180-day Schengen calculator for non-Schengen nationals. Days used, days remaining, overstay risk warnings, and re-entry date projections.

Trip Planning

Tool	Description
departi_search_accommodation	Curated accommodation with pricing across 189 European destinations. Persona-matched results (budget, mid-range, premium) with availability and booking links.
departi_search_transport	Flights, trains, and buses with pricing, travel time, and carrier details. Multi-modal results for complete route planning.
departi_search_experiences	Tours, activities, and local experiences matched to traveler personality. Curated beyond tourist traps.

Profile

Tool	Description
departi_get_profile	Authenticated user's nationality, tax residence, traveler type, travel history, and preferences. Powers personalized responses across all other tools.

Quick Start

Claude Desktop / Cursor / Windsurf

Add to your MCP configuration:

{
  "mcpServers": {
    "departi": {
      "type": "streamable-http",
      "url": "https://mcp.departi.eu/v3"
    }
  }
}

For personalized results (visa checks based on your nationality, Schengen tracking with your travel history), use the OAuth endpoint:

{
  "mcpServers": {
    "departi": {
      "type": "streamable-http",
      "url": "https://mcp.departi.eu/v3/oauth"
    }
  }
}

Claude.ai (Custom Connector)

1. Go to Settings → Connectors → Add custom connector
2. Enter URL: https://mcp.departi.eu/v3/oauth
3. Approve the OAuth consent screen
4. Connected — try the example prompts below

Example Prompts

Visa + Tax (multi-tool):

I'm American and planning to work remotely from Lisbon for 3 months starting in September. What visa do I need, and what are the tax implications for my US taxes?

Schengen tracking:

How many Schengen days do I have left? I've been in Portugal since March and Spain since May.

Trip planning (multi-tool):

I want to spend October in Split, Croatia. Find me a place to stay under €1,200/month, some local experiences, and check if I need a visa.

Tax residency comparison:

Compare the tax implications of establishing tax residency in Portugal vs Bulgaria as a US freelancer earning $120K/year.

Authentication

Path	Auth	Use Case
/v3	Anonymous + optional Bearer	General queries, registry introspection
/v3/oauth	OAuth 2.1 required	Personalized results, Schengen tracking, profile access

OAuth 2.1 Details

• PKCE: S256 (required)
• Dynamic Client Registration: RFC 7591
• Protected Resource Metadata: RFC 9728
• Authorization Server Metadata: RFC 8414
• Issuer Identification: RFC 9207
• Resource Indicators: RFC 8707
• Token lifetimes: Access 1h, refresh 30d with rotation

Discovery endpoints:

• https://mcp.departi.eu/.well-known/oauth-protected-resource/v3/oauth
• https://departi.eu/.well-known/oauth-authorization-server

Use Cases

• Digital nomads checking visa and tax obligations before relocating
• Remote workers understanding FEIE eligibility and tax home rules
• Long-term travelers tracking Schengen days to avoid overstays
• Travel planners finding accommodation, transport, and experiences in one query
• Tax advisors comparing residency regimes across European countries
• AI agents building travel compliance into automated itinerary planning

Data Coverage

• Visa data: 406 origin countries × 42 European destinations
• Tax profiles: 49 countries with income tax, social security, treaty, and filing data
• Accommodation: 189 European destinations with curated properties
• Transport: Flights, trains, buses across Europe
• Experiences: Activities and tours in all covered destinations

Links

• Documentation
• Website
• Privacy Policy
• Terms of Service

Support

• Email: support@departi.eu
• Issues: GitHub Issues

License

This repository contains documentation and configuration for the Departi MCP server. The server itself is a hosted service at mcp.departi.eu. See Terms of Service for usage terms.