{
  "markdown": "# @striderlabs/mcp-southwest\n\nMCP server for Southwest Airlines — search flights, manage bookings, check in, and manage your Rapid Rewards account via browser automation.\n\n## Features\n\n- **Search flights** with real-time pricing across all fare classes\n- **Compare fares**: Wanna Get Away, Wanna Get Away+, Anytime, Business Select\n- **Book flights** with dollars or Rapid Rewards points\n- **Manage reservations**: change, cancel, get details\n- **No change fees** — Southwest never charges them\n- **Check in** online (opens exactly 24 hours before departure)\n- **Get boarding passes** with group/position (A/B/C)\n- **Early Bird Check-In** — auto check-in 36 hours before departure\n- **Rapid Rewards** — check points balance, tier status, Companion Pass progress\n\n## Prerequisites\n\n- Node.js 18+\n- [Playwright browsers](https://playwright.dev/): `npx playwright install chromium`\n\n## Installation\n\n```bash\nnpm install -g @striderlabs/mcp-southwest\n# or\nnpx @striderlabs/mcp-southwest\n```\n\n## Setup\n\n### Environment Variables\n\nCreate a `.env` file or set these in your environment:\n\n```env\n# Required for account-based tools (check-in, Rapid Rewards, points booking)\nSW_USERNAME=your_rapid_rewards_number_or_email\nSW_PASSWORD=your_password\n\n# Optional\nSW_HEADLESS=true   # Set to \"false\" to see the browser (useful for debugging)\n```\n\n### Claude Desktop Configuration\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"southwest\": {\n      \"command\": \"npx\",\n      \"args\": [\"@striderlabs/mcp-southwest\"],\n      \"env\": {\n        \"SW_USERNAME\": \"your_rapid_rewards_number\",\n        \"SW_PASSWORD\": \"your_password\"\n      }\n    }\n  }\n}\n```\n\nOr if installed globally:\n\n```json\n{\n  \"mcpServers\": {\n    \"southwest\": {\n      \"command\": \"mcp-southwest\",\n      \"env\": {\n        \"SW_USERNAME\": \"your_rapid_rewards_number\",\n        \"SW_PASSWORD\": \"your_password\"\n      }\n    }\n  }\n}\n```\n\n## Available Tools\n\n### `search_flights`\nSearch for available Southwest flights.\n\n```json\n{\n  \"originAirport\": \"DAL\",\n  \"destinationAirport\": \"LAX\",\n  \"departureDate\": \"2024-06-15\",\n  \"passengers\": 2,\n  \"tripType\": \"oneway\",\n  \"fareType\": \"USD\"\n}\n```\n\n### `get_flight_details`\nGet status and details for a specific flight.\n\n```json\n{\n  \"flightNumber\": \"WN1234\",\n  \"flightDate\": \"2024-06-15\",\n  \"originAirport\": \"DAL\",\n  \"destinationAirport\": \"LAX\"\n}\n```\n\n### `select_flight`\nSelect a flight from search results to proceed with booking.\n\n```json\n{\n  \"flightIndex\": 0,\n  \"fareType\": \"wanna-get-away\"\n}\n```\n\n### `get_fares`\nCompare fare classes with pricing and benefits.\n\n```json\n{\n  \"originAirport\": \"HOU\",\n  \"destinationAirport\": \"MCO\",\n  \"departureDate\": \"2024-07-04\",\n  \"fareType\": \"USD\"\n}\n```\n\n### `add_early_bird`\nAdd Early Bird Check-In to an existing booking (~$15–25/person/flight).\n\n```json\n{\n  \"confirmationNumber\": \"ABC123\",\n  \"firstName\": \"Jane\",\n  \"lastName\": \"Smith\"\n}\n```\n\n### `checkout`\nComplete a booking with passenger and payment details.\n\n```json\n{\n  \"firstName\": \"Jane\",\n  \"lastName\": \"Smith\",\n  \"dateOfBirth\": \"01/15/1990\",\n  \"gender\": \"F\",\n  \"email\": \"jane@example.com\",\n  \"phone\": \"5551234567\",\n  \"cardNumber\": \"4111111111111111\",\n  \"cardExpiration\": \"12/26\",\n  \"cardCvv\": \"123\",\n  \"cardZip\": \"75201\",\n  \"cardName\": \"Jane Smith\",\n  \"addEarlyBird\": false\n}\n```\n\n### `get_reservation`\nLook up a booking by confirmation number.\n\n```json\n{\n  \"confirmationNumber\": \"ABC123\",\n  \"firstName\": \"Jane\",\n  \"lastName\": \"Smith\"\n}\n```\n\n### `change_flight`\nModify an existing booking (no change fees!).\n\n```json\n{\n  \"confirmationNumber\": \"ABC123\",\n  \"firstName\": \"Jane\",\n  \"lastName\": \"Smith\",\n  \"newDepartureDate\": \"2024-06-20\"\n}\n```\n\n### `cancel_flight`\nCancel a reservation. Use `confirm: true` to actually cancel.\n\n```json\n{\n  \"confirmationNumber\": \"ABC123\",\n  \"firstName\": \"Jane\",\n  \"lastName\": \"Smith\",\n  \"confirm\": true\n}\n```\n\n### `check_in`\nCheck in online (available 24 hours before departure).\n\n```json\n{\n  \"confirmationNumber\": \"ABC123\",\n  \"firstName\": \"Jane\",\n  \"lastName\": \"Smith\"\n}\n```\n\n### `get_boarding_pass`\nRetrieve boarding pass with group and position number.\n\n```json\n{\n  \"confirmationNumber\": \"ABC123\",\n  \"firstName\": \"Jane\",\n  \"lastName\": \"Smith\",\n  \"savePath\": \"~/boarding-pass.pdf\"\n}\n```\n\n### `get_rapid_rewards`\nCheck Rapid Rewards points, tier status, and Companion Pass progress.\n\n```json\n{}\n```\n*(Uses `SW_USERNAME`/`SW_PASSWORD` env vars)*\n\n### `book_with_points`\nSearch for flights and book using Rapid Rewards points.\n\n```json\n{\n  \"originAirport\": \"DAL\",\n  \"destinationAirport\": \"DEN\",\n  \"departureDate\": \"2024-08-10\",\n  \"passengers\": 1\n}\n```\n\n## Southwest Airlines Fare Classes\n\n| Fare | Refundable | Points Multiplier | Boarding |\n|------|-----------|-------------------|---------|\n| Wanna Get Away | Travel funds | 6x base | Standard |\n| Wanna Get Away+ | Transferable funds | 8x base | Standard |\n| Anytime | Full refund | 10x base | Priority (A1–A15) |\n| Business Select | Full refund | 12x base | Guaranteed A1–A15 |\n\n## Southwest Boarding System\n\nSouthwest uses **open seating** — no assigned seats. Passengers board in groups:\n- **Group A** (A1–A60): Early Bird / Business Select / Anytime priority\n- **Group B** (B1–B60): General boarding\n- **Group C** (C1–C60): Last to board\n\nCheck-in order determines boarding position. Check in exactly at the 24-hour mark for the best position.\n\n## Session Persistence\n\nLogin sessions are saved to `~/.config/mcp-southwest/session.json` to avoid re-authenticating on every run.\n\n## Development\n\n```bash\ngit clone https://github.com/markswendsen-code/mcp-southwest\ncd mcp-southwest\nnpm install\nnpx playwright install chromium\nnpm run build\nnpm start\n```\n\nFor development with hot reload:\n```bash\nnpm run dev\n```\n\nTo see the browser during automation (useful for debugging):\n```bash\nSW_HEADLESS=false npm run dev\n```\n\n## License\n\nMIT © Strider Labs\n",
  "bytes": 5863,
  "sha": "c810678523fddd5fc566d4cd53e5268e72509f4c16439f3ac2d928a848b879b5",
  "repo_slug": "markswendsen-code/mcp-southwest",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_markswendsen_code_southwest_9ebaeeab/readme"
}