# pointsyeah

Search award flights and travel deals using airline miles via PointsYeah. Compare bank transfer choices directly through your coding assistant.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 81
- Author: pulsemcp
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/pulsemcp/mcp-servers/tree/HEAD/experimental/pointsyeah
- Updated: 2026-10-09
- HTML: https://affpapa.org/en/nevibecode/mcp/pointsyeah

## What it does

This MCP server connects your coding agent to PointsYeah to check seat availability across 20+ frequent flyer programs. It checks reward point transfers from financial providers like Chase and Amex. Flight lookup runs in two steps: an HTTP POST call queries the Explorer API for initial route summaries, followed by up to 10 detail requests via CloudFront for complete itinerary segments.

You need Node.js 18+ and a PointsYeah account. The server relies on an AWS Cognito refresh token, which you can set in `POINTSYEAH_REFRESH_TOKEN` or provide via `set_refresh_token`. Because this token expires every 30 to 90 days, you will have to extract it from browser cookies again when calls fail.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `POINTSYEAH_REFRESH_TOKEN`, `ENABLED_TOOLGROUPS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env POINTSYEAH_REFRESH_TOKEN=<POINTSYEAH_REFRESH_TOKEN> --env ENABLED_TOOLGROUPS=<ENABLED_TOOLGROUPS> --transport stdio pointsyeah -- npx -y pointsyeah-mcp-server
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add pointsyeah --env POINTSYEAH_REFRESH_TOKEN=<POINTSYEAH_REFRESH_TOKEN> --env ENABLED_TOOLGROUPS=<ENABLED_TOOLGROUPS> -- npx -y pointsyeah-mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "pointsyeah": {
            "command": "npx",
            "args": [
                "-y",
                "pointsyeah-mcp-server"
            ],
            "env": {
                "POINTSYEAH_REFRESH_TOKEN": "<POINTSYEAH_REFRESH_TOKEN>",
                "ENABLED_TOOLGROUPS": "<ENABLED_TOOLGROUPS>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "pointsyeah": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "pointsyeah-mcp-server"
            ],
            "env": {
                "POINTSYEAH_REFRESH_TOKEN": "<POINTSYEAH_REFRESH_TOKEN>",
                "ENABLED_TOOLGROUPS": "<ENABLED_TOOLGROUPS>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e POINTSYEAH_REFRESH_TOKEN=<POINTSYEAH_REFRESH_TOKEN> -e ENABLED_TOOLGROUPS=<ENABLED_TOOLGROUPS> pointsyeah npx -y pointsyeah-mcp-server
```
Replace <…> with your own values

## When to use it
- search award seat availability across 20+ airline programs
- compare reward point transfer options from Chase or Amex
- check past flight search queries

## Example prompts
- Find business class award flights from JFK to LHR on October 15.
- Compare transfer options from Amex points for travel to Tokyo.
- Show my previous flight search history.

## Similar
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2197
- [Award Travel Finder](https://affpapa.org/en/nevibecode/mcp/award-travel-finder.md) — MCP server · ★ 12
- [flightclaw](https://affpapa.org/en/nevibecode/skills/flightclaw.md) — skill · 1100 installs
- [trvl](https://affpapa.org/en/nevibecode/mcp/trvl.md) — MCP server · ★ 90
- [wander-agent](https://affpapa.org/en/nevibecode/mcp/wander-agent.md) — MCP server · ★ 8
- [google-flights](https://affpapa.org/en/nevibecode/skills/google-flights.md) — skill · 3000 installs

From the same set: [pulsemcp/mcp-servers](https://affpapa.org/en/nevibecode/by/pulsemcp/mcp-servers.md) — 28 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md