Search Calendar
search_calendarFind the cheapest travel dates for a route. Provide origin/destination airports and target month/date. Returns price calendar showing best dates to travel. Supports V1 price trends (daily cheapest non-stop/one-stop/two-stop flights) and V2 matrix views. Optional: trip length, flight class, calendar type.
When to Use
Use this tool when you need to find the cheapest travel dates for a route. provide origin/destination airports and target month/date. returns price calendar showing best dates to travel. supports v1 price trends (daily cheapest non-stop/one-stop/two-stop flights) and v2 matrix views. optional: trip length, flight class, calendar type.. This is part of the Flight Search provider on xpay✦.
MCP Connection
Connect to xpay✦ to access this tool (and 3+ others):
{
"mcpServers": {
"xpay": {
"url": "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
}
}
}
For Claude Code:
claude mcp add --transport http xpay "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
How to Execute
Use the xpay✦ meta-tools to run this tool:
xpay_details— Get full input schema:xpay_details("flight-search/search_calendar")xpay_run— Execute:xpay_run("flight-search/search_calendar", { ...inputs })
Input Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
destination | string | Yes | IATA code for the destination airport (e.g., 'NRT'). |
date | string | Yes | |
options | object | No | |
origin | string | Yes | IATA code for the origin airport (e.g., 'LAX'). |
Pricing
- Cost: $0.01/call
- Balance check: Use
xpay_balanceto check remaining credits - Get your API key at xpay.tools — $5 free credits included
Related Skills
- Flight Search (all tools) — 4 tools
- Search Flights — $0.01/call
- Get Reference Data — $0.01/call
- Discover Flights — $0.01/call
Links
- Tool page: https://xpay.tools/flight-search/search-calendar/
- Provider: https://xpay.tools/flight-search/
- All tools: https://xpay.tools/explore
How to Execute
Input Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
destination | string | Yes | IATA code for the destination airport (e.g., 'NRT'). |
date | string | Yes | - |
options | object | No | - |
origin | string | Yes | IATA code for the origin airport (e.g., 'LAX'). |
Related Tools from Flight Search
Install Skill
Pricing
Cost
$0.01/call
Model
Flat rate
Provider
Flight Search

