search_packages
read-onlySearch live Umrah packages from verified travel agencies on Searchumrah. Every filter is optional; combine them freely. If nothing matches exactly, the search automatically relaxes the most flexible filters and says which ones it relaxed — tell the pilgrim. Prices are per person in the listed currency. Always share each package URL so the pilgrim can view and book it on searchumrah.com.
A pilgrim asks: “Find me a 15-day Umrah from Hyderabad in March under ₹1.2 lakh, hotel close to the Haram.”
| Argument | Type | Description |
|---|---|---|
| departure_city | string | City the pilgrim flies from, e.g. "Mumbai", "Hyderabad", "Kochi" or an airport code like "BOM". Use list_departure_cities to see cities with live packages. |
| month | string | Travel month, e.g. "March" or "Mar" or "3". Resolves to its next occurrence unless year is given. |
| year | integer (2024–2100) | Pin the month to a calendar year. |
| min_price | number | Minimum price per person. |
| max_price | number | Maximum price per person. |
| min_days | integer (1–90) | Minimum total trip length in days. |
| max_days | integer (1–90) | Maximum total trip length in days. |
| max_makkah_hotel_distance_m | integer (50–20000) | Maximum walking distance from the Makkah hotel to Masjid al-Haram, in metres. |
| min_makkah_hotel_stars | integer (1–5) | Minimum star rating of the Makkah hotel. |
| tags | string[] · Direct flight | Popular | Only packages carrying ALL of these tags. |
| offers_only | boolean | Only packages with a live limited-time discount. |
| agency | string | Limit to one agency, by its Searchumrah slug (from a previous result). |
| sort | string · recommended | price_low | price_high | newest | closest_to_haram | "recommended" (default) is Searchumrah's fair ranking: soonest departures first, one package per agency per round, then rating, rewards and discount. |
| page | integer (1–50) | 1-based page number. |
| page_size | integer (1–20) | Results per page (default 8). |
Example JSON-RPC request
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_packages",
"arguments": {
"departure_city": "Hyderabad",
"month": "March",
"min_days": 12,
"max_days": 16,
"max_price": 120000,
"max_makkah_hotel_distance_m": 500
}
}
}