Model Context Protocol
PointsYeah MCP Server
Connect AI clients to PointsYeah Explorer tools and query award opportunities without changing backend services.
Server URL
https://www.pointsyeah.com/api/mcp
Transport: Streamable HTTP
Auth: Public (Phase 1)
Tools: 9
Client Setup
Claude Desktop
Add this to your Claude Desktop MCP config.
{
"mcpServers": {
"pointsyeah": {
"url": "https://www.pointsyeah.com/api/mcp"
}
}
}Claude Code
Run this command in your terminal.
claude mcp add --transport http pointsyeah https://www.pointsyeah.com/api/mcpCursor
Use this in Cursor MCP global config.
{
"mcpServers": {
"pointsyeah": {
"url": "https://www.pointsyeah.com/api/mcp"
}
}
}Windsurf
Use this in Windsurf custom MCP server config.
{
"mcpServers": {
"pointsyeah": {
"serverUrl": "https://www.pointsyeah.com/api/mcp"
}
}
}Available Tools
flight_explorer_search
Flight Explorer Search
Search flight award opportunities by origin, destination, date range, cabins, and filters.
POST
/explorer/search
flight_explorer_filter_range
Flight Explorer Filter Range
Get min/max ranges for points, tax, and duration for a departure/arrival and date window.
POST
/explorer/get_filter_range
flight_explorer_map_aggregate
Flight Explorer Map Aggregate
Fetch aggregated map data for flight explorer results to power destination heatmaps.
POST
/explorer/search/aggregate
flight_explorer_total_count
Flight Explorer Total Count
Get the global total count of flight explorer opportunities.
GET
/explorer/count
hotel_explorer_search
Hotel Explorer Search
Search hotel explorer results with points/cash filters, programs, amenities, and pagination.
POST
/hotel/explorer/search
hotel_explorer_map
Hotel Explorer Map
Get country-level map aggregates for hotel explorer search filters.
POST
/hotel/explorer/map
hotel_explorer_recommend
Hotel Explorer Recommend
Fetch recommended hotel explorer properties.
POST
/hotel/explorer/recommend
hotel_detail_get
Hotel Detail
Get detailed property information by hotel property ID.
POST
/hotel/detail
hotel_calendar_get
Hotel Calendar
Get hotel explorer calendar price/points snapshots for a property and month.
POST
/hotel/explorer/calendar/v2
Try Prompts
Flight search with default date range
Use flight_explorer_search to find economy award options from LAX to JFK. Do not pass start_date or end_date, and use the tool's default range (today to one month later). Return top 5 lowest points results.
Flight filter range with default dates
Use flight_explorer_filter_range for SFO to LHR without start_date and end_date, then summarize min/max points, taxes, and duration.
Hotel search with default date range
Use hotel_explorer_search to find points-bookable hotels in Tokyo without start_date and end_date, sorted by lowest points first, top 10.
Hotel map aggregate default dates
Use hotel_explorer_map without start_date and end_date for Europe and summarize countries with the most properties.
Hotel detail + calendar
Get hotel details for property_id 15189 with hotel_detail_get, then call hotel_calendar_get for month 2026-04 and summarize best-value dates.
Date default: if `start_date` / `end_date` is omitted in explorer tools, MCP uses today through one month later.
Phase 1 exposes public read-only Explorer tools in Next.js API routes. Auth-protected tools (Travel Radar / Alerts) are planned for Phase 2.
Legal
The MCP Privacy Notice describes data flow specific to the MCP server and supplements our general Privacy Policy.