mcpField
I
ItalyFare MCP

ItalyFare MCP

Local
github.com/trendbenderMaps & Travel0Updated 17w ago
Repository

About ItalyFare MCP

ItalyFare MCP provides live fares for trains, buses, ferries, and private transfers across Italian routes. It is for travelers comparing transport prices and schedules through MCP-enabled clients.

Key features

  1. 01Live transport price searches
  2. 02Route listings for 71+ destinations
  3. 03Route price and time details
  4. 04Cheapest travel-day lookup

Use cases

  1. 01Compare transport prices between Italian cities
  2. 02Check route duration and fare details
  3. 03Find a lower-cost day to travel

MCP support

The MCP server exposes tools to search live fares, list routes, retrieve route details, and identify the cheapest travel day.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "italy-transfer": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote"
      ]
    }
  }
}
Run commandnpx -y mcp-remote

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmmcp-remote

Tools

4

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
from_citystringYes
to_citystringYes
datestringNo

Details

From the project README

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

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.