Skip to main content
Glama
Italy Transfers

Italy Transfers

by trendbender

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 dev

Starts on http://localhost:3000

MCP Server

The MCP server connects to the production Italy Transfers API.

cd mcp
# See mcp/README.md for deployment instructions

Related 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 integrations

Features

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 prices

  • list_italy_routes - List all 71+ available routes

  • get_route_info - Detailed price and time info

  • get_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

License

MIT

Support

For issues, questions, or contributions:

  1. Check CONTRIBUTING.md

  2. Review existing GitHub Issues

  3. Submit a new issue with details

Available Tools

4 tools
get_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

    A4/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool targets a distinct query: cheapest day, route details, list all routes, and search transport options. No overlap in purpose.

    Naming Consistency5/5

    All tools consistently use snake_case with verb_noun pattern (get, list, search). Naming is predictable and clear.

    Tool Count5/5

    4 tools cover the core informational needs for Italian transport without being too few or too many. Well-scoped for the server's purpose.

    Completeness5/5

    The set covers listing routes, route details, search with date, and cheapest day analysis. No obvious gaps for an informational transport server.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables 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
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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
    • A
      license
      A
      quality
      C
      maintenance
      Enables MCP-compatible AI agents to search live Virail transport connections across trains, buses, flights, ferries, and carpooling, returning real prices, schedules, and booking links.
      4
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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