Italy Transfers
Italy Transfers
Real-time train, bus, ferry and private transfer prices across Italian cities.
This package includes:
Frontend: Next.js 14 with i18n support (7 languages)
MCP Server: Claude MCP server for real-time price searches
Documentation: Architecture, research, and supplier information
Quick Start
Frontend (Next.js)
cd frontend
npm install
npm run devStarts on http://localhost:3000
MCP Server
The MCP server connects to the production Italy Transfers API.
cd mcp
# See mcp/README.md for deployment instructionsRelated MCP server: Lombardia Trains MCP
Project Structure
italy-transfer/
├── frontend/ # Next.js 14 app with next-intl
│ ├── app/ # App router pages
│ ├── components/ # React components
│ ├── lib/ # Utilities (price formatting, routing)
│ ├── messages/ # i18n translations (en, it, de, fr, es, ru, pt)
│ └── public/ # Static assets
├── mcp/ # Claude MCP server
│ ├── server.py # MCP implementation
│ ├── .mcp.json # MCP metadata
│ └── README.md # Deployment guide
└── docs/ # Documentation
├── ARCHITECTURE.md
├── research/ # SEO and market research
└── suppliers/ # Supplier integrationsFeatures
Frontend:
Real-time price search across 71+ Italian transport routes
Multi-language support (EN, IT, DE, FR, ES, RU, PT)
SEO-optimized static and incremental static regeneration
Mobile-responsive Tailwind CSS design
MCP Server:
search_italy_transport- Search routes with live priceslist_italy_routes- List all 71+ available routesget_route_info- Detailed price and time infoget_cheapest_travel_day- Find best travel day
Supported Routes
Rome, Milan, Florence, Venice, Naples, Palermo, Genoa, Turin, Bologna, Verona
All major airports (FCO, MXP, VCE, BGY, NAP)
Interconnected routes: 71+ popular destinations
Development
Language: TypeScript (frontend), Python (MCP) Framework: Next.js 14, FastMCP Styling: Tailwind CSS i18n: next-intl
Documentation
Architecture - System design and components
MCP Server - Claude integration guide
Contributing - Development workflow
License
MIT
Support
For issues, questions, or contributions:
Check CONTRIBUTING.md
Review existing GitHub Issues
Submit a new issue with details
Available Tools
4 toolsget_cheapest_travel_dayA
Find the cheapest day of the week to travel between two Italian cities.
Args: from_city: Origin city slug (e.g. 'rome', 'milan', 'florence') to_city: Destination city slug (e.g. 'rome', 'milan', 'florence')
Returns: Day-by-day price breakdown showing the cheapest day to travel
Inputs: to_city (required), from_city (required). Returns: result
get_route_infoB
Get detailed information about a transport route between two Italian cities, including available transport modes, price ranges, and travel times.
Args: from_city: Origin city slug (e.g. 'rome', 'milan', 'florence', 'venice', 'naples') to_city: Destination city slug
Returns: Detailed route information
Inputs: to_city (required), from_city (required). Returns: result
list_italy_routesA
List all available transport routes between Italian cities.
Returns: JSON list of routes with cheapest prices and number of offers
Inputs: no named parameters. Returns: result
search_italy_transportA
Search for transport options between two Italian cities.
Args: from_city: Origin city slug (e.g. 'rome', 'milan', 'florence', 'venice', 'naples', 'bologna') to_city: Destination city slug (e.g. 'rome', 'milan', 'florence', 'venice', 'naples', 'bologna') date: Optional travel date in YYYY-MM-DD format
Returns: JSON with transport options, prices, and operators
Inputs: to_city (required), from_city (required), date. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a distinct query: cheapest day, route details, list all routes, and search transport options. No overlap in purpose.
All tools consistently use snake_case with verb_noun pattern (get, list, search). Naming is predictable and clear.
4 tools cover the core informational needs for Italian transport without being too few or too many. Well-scoped for the server's purpose.
The set covers listing routes, route details, search with date, and cheapest day analysis. No obvious gaps for an informational transport server.
Maintenance
Related MCP Connectors
Search and book train tickets, Interrail passes and seat reservations across Europe.
Plan journeys by train, bus, tram, metro and ferry across 42 European countries.
Trips from Italy: flights, hotels and car hire with real prices, creator itineraries, booking link.
Find events, places and day plans in Italy. Free read-only access with links and source attribution.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables searching for buses and trains, and when direct routes are unavailable, it provides the underlying data needed to assemble multi-leg itineraries with transfers.1-
- AlicenseNot gradedqualityCmaintenanceEnables querying live departure and arrival boards, delays, platforms, cancellations, crowding, stop-by-stop progress, and journey planning with up to one change for Lombardy's regional rail network, using public open data without an API key.MIT

virail-mcpofficial
AlicenseAqualityCmaintenanceEnables MCP-compatible AI agents to search live Virail transport connections across trains, buses, flights, ferries, and carpooling, returning real prices, schedules, and booking links.41MIT- AlicenseNot gradedqualityCmaintenanceEnables querying real intercity bus data across Russia, including routes, prices, departure times, stations, transfers, road distances, and a price-per-km index, with ticket purchase links handed off to human buyers.MIT