Southwest

io.github.markswendsen-code由 GitHub 账号 markswendsen-code 发布v0.1.0更新于 Oct 24, 2026

MCP server for Southwest Airlines - search flights, manage bookings

已验证STDIO仅桌面位置与生活浏览器自动化

概览

AI 生成的概览

让助手搜索西南航空航班、比较票价、预订、更改或取消订单、办理登机手续并查看 Rapid Rewards 账户信息。

可以做什么
这个本地 MCP 服务器通过浏览器自动化操作西南航空网站。工具包括 search_flights 和 get_fares，用于查询各票价舱位的实时价格；get_flight_details 查询航班状态；select_flight 与 checkout 完成预订；book_with_points 使用 Rapid Rewards 积分支付。它还通过 get_reservation、change_flight 和 cancel_flight 管理已有行程，支持 check_in 与 get_boarding_pass，可添加 Early Bird Check-In，并读取 Rapid Rewards 积分、会员等级和 Companion Pass 进度。
适用场景
适合让助手查询西南航空票价与时刻、比较票价舱位，或处理常规行程事务，例如在起飞前 24 小时办理登机、获取登机牌、查看 Rapid Rewards 状态。也适合在不打开网站的情况下更改或取消已有订单。
运行要求
需要 Node.js 18+，并通过 npx playwright install chromium 安装 Playwright 浏览器。以 stdio 在本地运行，仅限桌面端。账户相关工具需要 SW_USERNAME 和 SW_PASSWORD，SW_HEADLESS 为可选。登录会话保存在 ~/.config/mcp-southwest/session.json。
安装前请注意
服务器要求提供西南航空凭据 SW_USERNAME 和 SW_PASSWORD，结账时还需完整支付卡信息，包括 cardNumber、cardExpiration、cardCvv 和 cardZip。它可以花钱预订航班或添加 Early Bird Check-In，也能更改或取消订单；取消需要 confirm: true。凭据与会话数据保存在本地，浏览器自动化会直接操作真实航空公司账户。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Southwest，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@striderlabs/mcp-southwest

MCP server for Southwest Airlines — search flights, manage bookings, check in, and manage your Rapid Rewards account via browser automation.

Features

  • Search flights with real-time pricing across all fare classes
  • Compare fares: Wanna Get Away, Wanna Get Away+, Anytime, Business Select
  • Book flights with dollars or Rapid Rewards points
  • Manage reservations: change, cancel, get details
  • No change fees — Southwest never charges them
  • Check in online (opens exactly 24 hours before departure)
  • Get boarding passes with group/position (A/B/C)
  • Early Bird Check-In — auto check-in 36 hours before departure
  • Rapid Rewards — check points balance, tier status, Companion Pass progress

Prerequisites

Installation

bash
npm install -g @striderlabs/mcp-southwest# ornpx @striderlabs/mcp-southwest

Setup

Environment Variables

Create a .env file or set these in your environment:

env
# Required for account-based tools (check-in, Rapid Rewards, points booking)SW_USERNAME=your_rapid_rewards_number_or_emailSW_PASSWORD=your_password
# OptionalSW_HEADLESS=true   # Set to "false" to see the browser (useful for debugging)

Claude Desktop Configuration

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

json
{  "mcpServers": {    "southwest": {      "command": "npx",      "args": ["@striderlabs/mcp-southwest"],      "env": {        "SW_USERNAME": "your_rapid_rewards_number",        "SW_PASSWORD": "your_password"      }    }  }}

Or if installed globally:

json
{  "mcpServers": {    "southwest": {      "command": "mcp-southwest",      "env": {        "SW_USERNAME": "your_rapid_rewards_number",        "SW_PASSWORD": "your_password"      }    }  }}

Available Tools

search_flights

Search for available Southwest flights.

json
{  "originAirport": "DAL",  "destinationAirport": "LAX",  "departureDate": "2024-06-15",  "passengers": 2,  "tripType": "oneway",  "fareType": "USD"}

get_flight_details

Get status and details for a specific flight.

json
{  "flightNumber": "WN1234",  "flightDate": "2024-06-15",  "originAirport": "DAL",  "destinationAirport": "LAX"}

select_flight

Select a flight from search results to proceed with booking.

json
{  "flightIndex": 0,  "fareType": "wanna-get-away"}

get_fares

Compare fare classes with pricing and benefits.

json
{  "originAirport": "HOU",  "destinationAirport": "MCO",  "departureDate": "2024-07-04",  "fareType": "USD"}

add_early_bird

Add Early Bird Check-In to an existing booking (~$15–25/person/flight).

json
{  "confirmationNumber": "ABC123",  "firstName": "Jane",  "lastName": "Smith"}

checkout

Complete a booking with passenger and payment details.

json
{  "firstName": "Jane",  "lastName": "Smith",  "dateOfBirth": "01/15/1990",  "gender": "F",  "email": "[email protected]",  "phone": "5551234567",  "cardNumber": "4111111111111111",  "cardExpiration": "12/26",  "cardCvv": "123",  "cardZip": "75201",  "cardName": "Jane Smith",  "addEarlyBird": false}

get_reservation

Look up a booking by confirmation number.

json
{  "confirmationNumber": "ABC123",  "firstName": "Jane",  "lastName": "Smith"}

change_flight

Modify an existing booking (no change fees!).

json
{  "confirmationNumber": "ABC123",  "firstName": "Jane",  "lastName": "Smith",  "newDepartureDate": "2024-06-20"}

cancel_flight

Cancel a reservation. Use confirm: true to actually cancel.

json
{  "confirmationNumber": "ABC123",  "firstName": "Jane",  "lastName": "Smith",  "confirm": true}

check_in

Check in online (available 24 hours before departure).

json
{  "confirmationNumber": "ABC123",  "firstName": "Jane",  "lastName": "Smith"}

get_boarding_pass

Retrieve boarding pass with group and position number.

json
{  "confirmationNumber": "ABC123",  "firstName": "Jane",  "lastName": "Smith",  "savePath": "~/boarding-pass.pdf"}

get_rapid_rewards

Check Rapid Rewards points, tier status, and Companion Pass progress.

json
{}

(Uses SW_USERNAME/SW_PASSWORD env vars)

book_with_points

Search for flights and book using Rapid Rewards points.

json
{  "originAirport": "DAL",  "destinationAirport": "DEN",  "departureDate": "2024-08-10",  "passengers": 1}

Southwest Airlines Fare Classes

FareRefundablePoints MultiplierBoarding
Wanna Get AwayTravel funds6x baseStandard
Wanna Get Away+Transferable funds8x baseStandard
AnytimeFull refund10x basePriority (A1–A15)
Business SelectFull refund12x baseGuaranteed A1–A15

Southwest Boarding System

Southwest uses open seating — no assigned seats. Passengers board in groups:

  • Group A (A1–A60): Early Bird / Business Select / Anytime priority
  • Group B (B1–B60): General boarding
  • Group C (C1–C60): Last to board

Check-in order determines boarding position. Check in exactly at the 24-hour mark for the best position.

Session Persistence

Login sessions are saved to ~/.config/mcp-southwest/session.json to avoid re-authenticating on every run.

Development

bash
git clone https://github.com/markswendsen-code/mcp-southwestcd mcp-southwestnpm installnpx playwright install chromiumnpm run buildnpm start

For development with hot reload:

bash
npm run dev

To see the browser during automation (useful for debugging):

bash
SW_HEADLESS=false npm run dev

License

MIT © Strider Labs

来源：README.md，提交 9cbed37

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.0最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。