---
name: "xpay-flight-search-search-calendar"
description: "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."
version: "1.0.0"
price: "$0.01/call"
provider: "Flight Search"
---

# Search Calendar

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.

**Provider:** Flight Search
**Price:** $0.01/call
**Pricing model:** Flat rate per call

## 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):

```json
{
  "mcpServers": {
    "xpay": {
      "url": "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
    }
  }
}
```

For Claude Code:
```bash
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:

1. **`xpay_details`** — Get full input schema: `xpay_details("flight-search/search_calendar")`
2. **`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_balance` to check remaining credits
- Get your API key at [xpay.tools](https://xpay.tools/account/settings/api-keys/) — $5 free credits included

## Related Skills

- [Flight Search (all tools)](https://xpay.tools/skills/flight-search/SKILL.md) — 4 tools
- [Search Flights](https://xpay.tools/skills/flight-search/search-flights/SKILL.md) — $0.01/call
- [Get Reference Data](https://xpay.tools/skills/flight-search/get-reference-data/SKILL.md) — $0.01/call
- [Discover Flights](https://xpay.tools/skills/flight-search/discover-flights/SKILL.md) — $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