perun-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
perun-mcp
An MCP (Model Context Protocol) server for Perun.search — a Polish trip planner that finds cheap flights and pairs each destination with the nearest InPost parcel locker and hotel, so you can ship your luggage ahead instead of paying airline baggage fees.
This is a thin HTTP client: it contains no trip-planning logic of its
own. Every tool call is a plain GET request against the public API at
https://perunsearch.tours/api, and the JSON response is returned as-is to
your agent. All flight/locker/pricing logic lives server-side.
Quickstart
git clone https://github.com/swiru95/perun-mcp
cd perun-mcp
pip install -r requirements.txt # or: uv pip install -r requirements.txtRegister with Claude Code
claude mcp add perun -- python /path/to/perun-mcp/server.pyClaude Desktop / other stdio clients
Add to your MCP client config:
{
"mcpServers": {
"perun": {
"command": "python",
"args": ["/path/to/perun-mcp/server.py"]
}
}
}Pointing at a different API base (optional)
By default the server calls https://perunsearch.tours/api. Override with:
export PERUN_API_BASE="https://your-host/api"Related MCP server: hotels-skill
Tools
Tool | Description |
| List departure airports (IATA, city, country). |
| Cheapest flights from |
| Live fare lookup for one specific route/date (all covered airlines). Budget-limited server-side and cached — use sparingly. |
| LOT domestic "fly to" destinations from a given Polish airport. |
| Currently popular/recently priced routes, plus fare-lookup budget status. |
All tools raise a clear error (with the API's error message, when present)
on a non-200 response.
Disclaimer
Prices, availability, and locker/hotel data returned by these tools are indicative only and sourced live from third parties (airlines, InPost, hotel providers) — they are not guaranteed and may change before you book. Booking links included in results point to the airline/provider directly; Perun.search does not process payments or bookings itself.
See the full terms at perunsearch.tours/regulamin.html.
Fair use
This server calls the public Perun.search API. Please be a good citizen:
avoid hammering route_fares (it triggers live, budget-limited third-party
lookups) and prefer plan_trip for broad searches.
License
MIT — see LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Give AI assistants access to real-time data. Search the web, compare flights, find hotels, and more.
Travel tools for AI agents: plan and edit real trips, search stays and tours, import travel videos.
Web search, page reading, HTML to PDF, file upload and flight search for AI agents, paid in USDC.
Free web search, 130M+ business records, local search, weather and travel data for AI agents.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to search, browse, and book hotels from a database of 2 million properties worldwide. Provides comprehensive hotel search capabilities with location lookup, filtering by amenities, detailed property information, and integrated booking functionality.61ISC
- AlicenseNot gradedqualityDmaintenanceEnables real-time hotel search and pricing data from Booking.com for AI agents and Claude.2ISC
- AlicenseNot gradedqualityBmaintenanceEnables live flight search and pricing via the Duffel Flights API, allowing AI agents to query flight data and pricing.163 npmMIT
- AlicenseAqualityBmaintenanceEnables AI agents to search Polish public transport timetables — trains, PKS/regional buses, and optionally urban transit in ~20 cities — by planning journeys with transfers, checking departures with platforms, and tracking live delays, cancellations and full trip details, all from open GTFS data without an API key. Station lookup tolerates typos and missing Polish diacritics, and endpoints can be a stop, a whole city, or coordinates.666 npm37MIT