Eu261 MCP Server

eu261-mcp

An MCP server for EU261/2004 flight-delay compensation — check eligibility, compute expected value, track fare history. Runs on Cloudflare Workers with Durable Objects.

Live: eu261.danielsuchan.dev/mcp

Tools

EU261 rules (encoded)

• 3h+ arrival delay at final destination → compensation (still in force 2026)
• €250 ≤1500km · €400 1500–3500km · €600 >3500km
• €300 (50% cut, Art 7(2)) if >3500km flight arrives 3–4h late
• Any flight departing EU/EEA = covered regardless of carrier
• Arriving EU/EEA from non-EU = covered only on an EU carrier
• Extraordinary circumstances (weather, ATC, strikes) = no compensation

Connect

MCP Inspector

Transport: Streamable HTTP
URL: https://eu261.danielsuchan.dev/mcp
Connection: Direct

Claude Code

Add to your MCP settings:

{
  "mcpServers": {
    "eu261": {
      "type": "url",
      "url": "https://eu261.danielsuchan.dev/mcp"
    }
  }
}

REST API

For machine-to-machine (no MCP session needed):

# Record a price
curl -X POST https://eu261.danielsuchan.dev/api/record-price \
  -H 'Content-Type: application/json' \
  -d '{"route":"VIE-JFK","fare_eur":574,"carrier":"Austrian","routing":"nonstop"}'

# Batch record
curl -X POST https://eu261.danielsuchan.dev/api/record-prices \
  -H 'Content-Type: application/json' \
  -d '[{"route":"VIE-JFK","fare_eur":574,"carrier":"Austrian","routing":"nonstop"}]'

# Get price history
curl https://eu261.danielsuchan.dev/api/prices?route=VIE-JFK

# Health check
curl https://eu261.danielsuchan.dev/health

Deploy your own

# Clone
git clone https://github.com/MrSucik/eu261-mcp.git
cd eu261-mcp

# Install
npm install --legacy-peer-deps

# Create KV namespace
npx wrangler kv namespace create EU261_PRICES
# Update the KV ID in wrangler.jsonc

# Deploy
npx wrangler deploy

Test

npm test

Architecture

• Cloudflare Worker — edge runtime, global
• Durable Object (McpAgent) — stateful MCP server with SQLite-backed state
• KV — price history (REST API writes)
• Pure logic in src/eu261.ts — no side effects, fully tested

License

MIT