Indian Railways MCP

🚀 Indian Railways MCP Server

The Indian Railways MCP Server provides real - time station status and train information using the Model Context Protocol (MCP). This server is designed to handle real - time data requests from Indian Railways.

🚀 Quick Start

The Indian Railways MCP Server offers real - time station status and train information. It uses the Model Context Protocol (MCP) to handle data requests from Indian Railways.

✨ Features

• Get real - time station status.
• Query train information.
• Obtain detailed train information between stations.
• Get train information based on a specific date.
• Query train route information.
• Check PNR status.

💻 Usage Examples

Example Link

📦 Installation

1. Clone the repository:

   git clone https://github.com/yourusername/indian-railways-mcp.git
   cd indian-railways-mcp
   

2. Install dependencies:

   npm install
   

💻 Usage

1. Build the project:

   npm run build
   

2. Start the server:

   npm start
   

3. Test the functions:

   node --loader ts-node/esm src/testFunctions.ts
   

📚 Documentation

API

Get Real - Time Station Status

• Endpoint: tools/call
• Method: get-station-live-status
• Parameters:
  • stationCode: The code of the station for which you want to get the real - time status.

Get Detailed Train Information Between Stations

• Endpoint: tools/call
• Method: get-trains-between-stations
• Parameters:
  • from: The code of the departure station.
  • to: The code of the destination station.

Get Train Information Based on Date

• Endpoint: tools/call
• Method: get-trains-on-date
• Parameters:
  • from: The code of the departure station.
  • to: The code of the destination station.
  • date: The date in the format YYYY - MM - DD.

Query Train Route Information

• Endpoint: tools/call
• Method: get-train-route
• Parameters:
  • trainNo: The train number.

Check PNR Status

• Endpoint: tools/call
• Method: get-pnr-status
• Parameters:
  • pnr: The PNR number.

Example Queries

Here are some example queries you can use with the API:

Get the real - time status of New Delhi South Station (NDLS)

{
    "method": "get-station-live-status",
    "params": {
        "stationCode": "NDLS"
    }
}

Get all information about train number 12059

{
    "method": "get-train-details",
    "params": {
        "trainNo": "12059"
    }
}

Query the complete route of train number 12059

{
    "method": "get-train-route",
    "params": {
        "trainNo": "12059"
    }
}

Get the real - time status of Lucknow Station (LN*)

{
    "method": "get-station-live-status",
    // The original README seems incomplete here, but I keep it as it is.
}