# Shinkansen Routing Optimizer AI Agent Connect

> Deterministic Japanese Shinkansen travel time and fare calculator.

## Overview
- **Category:** travel
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_R9OWPEPU50j4EI5NUOTMcIxngAaDCvRcPB9fw7kt/ai-agent-connect
- **Tags:** japan, shinkansen, travel-planner, fare-calculator, railway

## Description

This MCP server provides precise calculations for Shinkansen travel in Japan. Use `calculate_route_details` to find travel duration, intermediate stops, and transfer requirements. Use `calculate_fare_breakdown` to get a complete cost analysis including base fares, express surcharges, and Green Car upgrades. You can also use `check_jr_pass_eligibility` to verify if a specific train type is covered by a standard JR Pass.

## Tools

### calculate_fare_breakdown
Determines the exact financial cost of the journey

### calculate_route_details
Calculates core travel metrics including time, stops, and transfer needs

### check_jr_pass_eligibility
Determines if the selected journey is covered by a standard JR Pass

## Prompt Examples

**Prompt:** 
```
How much does it cost to go from Tokyo to Kyoto on a Nozomi in Green Car?
```

**Response:** 
```
The total fare for a Green Car trip from Tokyo to Kyoto on the Nozomi is 22,500 JPY, consisting of a 14,000 JPY base fare, 6,500 JPY express surcharge, and 2,000 JPY Green Car upgrade fee.
```

**Prompt:** 
```
How long is the trip from Shin-Osaka to Nagoya using the Kodama?
```

**Response:** 
```
The travel time from Shin-Osaka to Nagoya via Kodama is 50 minutes with 2 intermediate stops.
```

**Prompt:** 
```
Is the Hikari train covered by a standard JR Pass?
```

**Response:** 
```
Yes, the Hikari train is fully covered by a standard JR Pass.
```

## Frequently Asked Questions

**How do I calculate the total cost of my trip?**
You can use the `calculate_fare_breakdown` tool, which provides the base fare, express surcharge, and any Green Car upgrade fees to give you a total cost.

**Is the Nozomi train covered by the JR Pass?**
You can verify this using `check_jr_pass_eligibility`. Generally, Nozomi requires a special supplement, while Hikari and Kodama are fully covered.

**Can I see how many stops are between my stations?**
Yes, the `calculate_route_details` tool returns the exact number of intermediate stops between your origin and destination.