xpay tools logo
  • Tools
  • Collections
  • Skills
  • Docs
  • xpay.sh
Tool Skill
Flight Search logo

Search Calendar

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.

$0.01/call
Flat rate
Flight Search
Raw SKILL.mdTool Page

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:

  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

ParameterTypeRequiredDescription
destinationstringYesIATA code for the destination airport (e.g., 'NRT').
datestringYes
optionsobjectNo
originstringYesIATA 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 — $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
// 1. Get full schema
xpay_details("flight-search/search_calendar")
// 2. Execute
xpay_run("flight-search/search_calendar", { ...inputs })
Input Parameters
ParameterTypeRequiredDescription

destination

string
Yes

IATA code for the destination airport (e.g., 'NRT').

date

string
Yes

-

options

objectNo

-

origin

string
Yes

IATA code for the origin airport (e.g., 'LAX').

Related Tools from Flight Search
Search Flights — $0.01Get Reference Data — $0.01Discover Flights — $0.01
Install Skill
Claude Code
claude /install-skill https://xpay.tools/skills/flight-search/search-calendar/SKILL.md
CLI
npx @xpaysh/cli install flight-search/search-calendar
Manual
curl -o SKILL.md https://xpay.tools/skills/flight-search/search-calendar/SKILL.md
Pricing

Cost

$0.01/call

Model

Flat rate

Provider

Flight Search

xpay tools logo

Marketplace for AI Capabilities. Run agents, tools & prompts with pay-per-use micropayments.

or ask your AI app
Popular Tools
FirecrawlTavilyExaHunterPerplexityRecraftIdeogramFlux
Collections
AI Image & MediaContent & ResearchDev ToolsFinanceLead GenWeb ScrapingCompetitive Intel
Developers
DocumentationAPI ReferenceQuickstartSDKsSkillsskill.mdllms.txt
Resources
The Agentic EconomyAgentic CommerceAgent Frameworksx402 ProtocolBlog
Company
About xpayxpay.shGitHubDiscordTwitter / X

© 2026 Agentically Inc. All rights reserved.
Privacy PolicyTerms of Service