AwardMath MCP 서버

awardmath-mcp은 Model Context Protocol을 통해 공개 AwardMath API에 AI 어시스턴트를 연곁합니다.

AwardMath는 여행 포인트 최적화 도구입니다. 포인트 잔액과 여행 목표를 제목하면, 결정적 솔버가 전환 비율 및 발권 차트의 버전 지정된 그래프를 탐색한 다음, 최대 세 개의 검중되고 설명 가능한 예약 계획을 반환합니다.

수학은 공개된 차트에 대한 열거와 채점에 불과합니다. LLM이 질문을 파싱하고 결곸를 설명할 수는 있지만, 계획을 선택하거나 최적화하지 않습니다.

이 저장소에는 Model Context Protocol 서버와 data/ 아래에 있는 무료 데이터 스냡샷이 포함되어 있습니다. 서버는 읽기 전용입니다. API 키, 로그인, 구독이 필요하지 않으며, 항공사 웹 사이트를 스크랲하지 않습니다.

도구

서버는 세 가지 도구를 찾을 수 있습니다.

확인: "Parse" maybe "parse" translate "파싱".

Let me redo the table translation in the final.

I'll produce the final code:

Acc" maybe " AwardMath MCP 서버 ".

I think I'm ready. Let me produce the# AwardMath MCP 서버

awardmath-mcp는 Model Context Protocol을 통해 공개 AwardMath API에 AI 어시스턴트를 연결합니다.

AwardMath는 여행 포인트 최적화 도구입니다. 포인트 잔액ㄷ과 여행 목표를 제공하면, 결정 솔버가 전환율 및 발권 차트로 이루어진 버전 지정 그래프를 탐색한 뒤, 최대 세 개의 검중되고 설명 있는 예약 계획을 반환합니다.

수학은 공개된 차트를 대상으로 열거하고 + 점수를 내는 방식입니다. LLM은 질문을 파싱하고 결과를 설명하기만 하며, 계획을 고르거나 최적화하지 힇니.

이 저장소에는 MCP 서버와 data/ 아래에 있는 무료 데이터 스냅샷이 담겨 있습니다. 서버는 읽을 전용이며, API 키, 로그인, 구독을 요구하지 않고, 항 공사의 사이트를 스크랲하지 않습니다.

도구

서버는 세 가지 도구 모 든 기능을 제공합니다.

list_programs

list_programs은 AwardMath가 추적하는 모든 프로그램을 반환고, 현재 solv가 사용할 수 있는 프로그램 ID를 알려합니다.

사용 가능한 프로그램에는 가격이 확정된 차트를 갖추적임 보상 프로그램과, 그중 하나로 전환이 가능한 행(은행) 포인트 종류가 포함됩니다. 이 구분은 어시스턴트가 어떤 잔액을 발권 차트로 갈 수 없는 상태에서 솔버에게 그 잔액으로 결하라고 요청하지 않도록 막습니다.

solve_ward_trip`

solve_ward_trip`는 지갖, 출발지, 목적지, 시좌 등급, 여행자 수, 지불 특정 상한을 기반으로 예약 계획을 찾아줍니다.

성공 시 응답에는 최대 계산 개의 계획이 포함되며, 각 계획에는 다음은 것이 포함됩니다.

• 정확한 전환 과정

• 필오한 총 포인트 수

• 산정된 수수료

조건에 알맞은 계획이 없으면, 응답에는 no_plan_reasons이 함됩니다. 이 값은 추측이나 예상하지 않은 경로로 부족한 부분을 메우지 않고 실패한 제약 조항을 명확히 지적합니다.

미구조화:

파일_wallet

parse_wallet은 자연어 텍스트를 구조화된 잔액으로 바니다.

예시는 다음과 같습니다.

250k Amex, 80k Chase

명확한 잔액은 프로고램 ID와 금액이 됩니다. 모호한 표현은 암의적으르 프로르램에 할당하지 않습니다. "명확화"을 요청하는 형태로 표리됩니다.

설지

Git|Hub|Hub에서 직접 서버를 실하지, clone본을 설치하도 됩니다.

Claude Code

claude mcp add awardmath -- uvx --from git+https://github.com/DanCastHub/awardmath-mcp awardmath-mcp

Claude Desktop 또는 다른 JSON로 설정된 "클율"

{
  "mcpServers": {
    "awardmath": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/DanCastHub/awardmath-mcp", "awardmath-mcp"]
    }
  }
}

Clone에서

pip install -e .
awardmath-mcp

API 키나 AwardMath 계정은 필요 없습니다.

예시

당신이 있는 시용자 계획과 사용할 포인트로 예약을 요청하세요.

사용자: 60,000 Amex Membership Rewards 포인트가 있습니다. LA에서 HNL까지의 발권 우 이동시트 한 자리를 찾아영습니다.

거시턴트: 2026-08s-23에, 가장 저렴한 "SEAT" 계획은 "港权"을charter use 16,000 Qatar Aeros를 사용했습니다. Amex Membersh포인트이 1:1 전환, 지금 중 하나를 충당한 것입니다. 결에는 정확환 환 단계, 총 포인트, 수수료을 포함됩니다. 좌석이 예약 가능한 지는 확ất하지 않습니다.

결항은 날짜가 지정되어 있습니다. 전환율환과 차트 가격은 변하기 때문입니다. 새운 solve를 실기하고, 발권 좌석을 확정한 후, 포인트를 옴기기 전에 다시 한 번 전환 조건 및 주의하시기 위한 예.

데처

"데이터 채 둰": 디렉토리(data/)에서원일된 그래프 조각과 실해되는 출즈를 확인할 수 있습니다.

리소코 data/transfer-ratios-current.csv

이 파일에는 8개의 출발 시발 지갑의 적라기의 전환 연결 정보, 정소 109조.

각 줄은 AwardMath가 기한 데이타를 확정하거나 다른 소소를 비교대조 가장 최신으로 확인한 관측값입니다. 직접 확정되지 않찬거나 확인되지 않은 확은 주장은 제의되었습니다.

포인트:

• 전환율

• 수수료 등

• 전환 시일, 관측환됨

• 확정 상태

• 관측 날짜 와

환율은 변합니다. 각 줄은 관측 째짜을 기준으로만 유효하며, 껴포인트를 보내기 전반 "평훐"에서 다시 확인하세요.

data/sample-solved-plans.json

이 파일에는 라이브 솔버를 사용해 시나리오 2026-08-23대로 시연된 예, 5가지를.

네가지 중 하나의 시나리오는 계획이 포함됩니다:

• 이코노미 좌석에서레 LAX↔HNL, 60,000 Amex Membership Rewards

• 비즈니스 좌석도 SFO-HND, 100,000 Amex Membership Rewarks 이 있고, ANA 발권의 82,000" 발권에서 총 사용수를 확보.

나머지 시나리오 중 하나는 의도적으로 결과가 없습니다. YVR–DXB 비즈니스 발권 검색은 그래프가 경로 차트를 가지지 못한 상황에서 대신 방법과 찾는 것이 아니라 결여프가 제공되는 그래표기를 유지할 필요한지명합니다.

속하는 않것

이 데이터셋은 전체 데이터 셋의 전부가 아닌 일부 선택된 스냅샷입니다.

전체의 업역사 버전의 내역은 그및에주갑은 awardmath.com 웹 사이트에 보유합니다. 전체 이택은 기간 동안 전환율과 발권 차트의 진확을 추적하하고, 즉시 발권 조회 및 서기/대기 조회 "기술 지원"을 제공합니다. 이건 이 git프포지토리에 포함되지 않습니다.

이 용은 해주지 않는 것

실시가각 상태 좌석 예약 여부를 확인하지 않습니다.

발권 계획은 공식 발권 차트과 전환 비율로 취합니다. 임의 경로는 수럼적으로 유효하좌 할 수 있지만, 시기일에 좌석이 예매이 안 될 수 있습니다.

포인트를 예약 이전에:

1. 발권 좌석 확은 서비스는 Seats.aero "갑빈보" 또는 항공사를 통해 확인하십시오.

2. 예약 시 항공가의 요구하는 "포인트 마이지" 숫과 "수수료"을 확인하십시오.

3. 전환율과 조건을 다시 확인하십시오.

전환은 취소할 수 없습니다. 솔v버가 예약 가능한 경로를 찾겠다고 해서 전환하지 마십오. 발권 좌석을 확정하고 나서 전환하세요.

AwardMath는 수학적 계산를 검증하나, 예약가좌석확인 사람은 당신입니다.

라이센소

코드는 MIT License에 따라 공개되어 있습니다.

data/ 이하의 데이터는 CC BY 4.0에 따르습니다. 다음은 저작출 표시에는 링크가 필요합니다.

AwardMath 리소스: AwardMath

출처:

• AwardMath *저자] awardmath-mcp 응용 저장소