// Request
{ "date": "2026-06-01", "region": "WA" }

// Response
{
  "summary": "2026-06-01 (Monday) IS a public holiday in WA: \"Western Australia Day\" [regional].",
  "data": {
    "query": { "date": "2026-06-01", "day_of_week": "Monday", "region": "WA" },
    "result": {
      "is_public_holiday": true,
      "holiday": { "name": "Western Australia Day", "date": "2026-06-01", "type": "regional", "region": "WA" }
    },
    "all_holidays_for_region": [ ... ]
  }
}

// Request
{ "date": "2026-03-15", "region": "TAS" }

// Response
{
  "summary": "2026-03-15 (Sunday) is in TAS Term 1 2026 (Week 6, 19 school days remaining).",
  "data": {
    "result": {
      "in_school_term": true,
      "current_term": {
        "label": "Term 1 2026", "start": "2026-02-04", "end": "2026-04-09",
        "week_number_in_term": 6, "school_days_elapsed": 25, "school_days_remaining": 19
      }
    }
  }
}

// Request
{ "date": "2026-04-25", "region": "NZ" }

// Response
{
  "summary": "Next business day after 2026-04-25 (Saturday) in NZ is 2026-04-27 (Monday), 2 calendar days ahead.",
  "data": {
    "input_date_status": { "is_business_day": false, "is_weekend": true, "is_public_holiday": true, "public_holiday_name": "ANZAC Day" },
    "next_business_day": { "date": "2026-04-27", "day_of_week": "Monday", "calendar_days_ahead": 2 },
    "skipped_due_to": []
  }
}

x-api-key: sk-anz-<your-key-here>

{
  "mcpServers": {
    "anz-schedule-brain": {
      "command": "node",
      "args": ["/path/to/anz-schedule-brain/dist/index.js"]
    }
  }
}

{
  "mcpServers": {
    "anz-schedule-brain-remote": {
      "url": "https://anz-schedule-brain-production.up.railway.app/sse",
      "headers": {
        "x-api-key": "sk-anz-<your-key-here>"
      }
    }
  }
}

git clone https://github.com/TyrenTemp/anz-schedule-brain.git
cd anz-schedule-brain
npm install
cp .env.example .env      # no key needed for local dev
npm run dev               # tsx watch, stdio transport

npm install -g @railway/cli
railway login
railway init              # link to your Railway project
railway variables set MCP_TRANSPORT=sse
railway up                # build + deploy
railway domain            # generates your public URL

src/
├── index.ts              # FastMCP server, auth middleware, transport switcher
└── data/
    ├── holidays.ts       # ALL_PUBLIC_HOLIDAYS static object (9 regions × 2026+2027, O(1) lookup map)
    └── schoolTerms.ts    # ALL_SCHOOL_TERMS static object (9 regions × 4 terms × 2026+2027)