NS Travel Information Server

Instructions

Implementation Reference

• src/services/NSApiService.ts:108-121 (handler)

  Core implementation of the get_station_info tool handler, which queries the NS stations API endpoint with the provided query, optional flags, and limit.

  async getStationInfo(args: StationInfoArgs): Promise<StationInfoResponse> {
    this.ensureApiKeyConfigured();
    const response = await this.axiosInstance.get<StationInfoResponse>(
      NSApiService.ENDPOINTS.STATIONS,
      {
        params: {
          q: args.query,
          includeNonPlannableStations: args.includeNonPlannableStations ?? false,
          limit: args.limit ?? 10
        }
      }
    );
    return response.data;
  }

• src/types.ts:408-421 (schema)

  TypeScript interface definition and type guard validator for the input arguments of get_station_info.

  export interface StationInfoArgs {
    query: string;
    includeNonPlannableStations?: boolean;
    limit?: number;
  }
  
  export function isValidStationInfoArgs(args: any): args is StationInfoArgs {
    return (
      typeof args === 'object' &&
      typeof args.query === 'string' &&
      (args.includeNonPlannableStations === undefined || typeof args.includeNonPlannableStations === 'boolean') &&
      (args.limit === undefined || (typeof args.limit === 'number' && args.limit >= 1 && args.limit <= 50))
    );
  }

• src/types.ts:465-467 (schema)

  TypeScript interface definition for the output response of get_station_info.

  export interface StationInfoResponse {
    payload: Station[];
  }

• src/index.ts:149-174 (registration)

  MCP tool registration in the stdio server (index.ts), including name, description, and JSON input schema.

  {
    name: 'get_station_info',
    description: 'Get detailed information about a train station',
    inputSchema: {
      type: 'object',
      properties: {
        query: {
          type: 'string',
          description: 'Station name or code to search for',
        },
        includeNonPlannableStations: {
          type: 'boolean',
          description: 'Include stations where trains do not stop regularly',
          default: false
        },
        limit: {
          type: 'number',
          description: 'Maximum number of results to return',
          minimum: 1,
          maximum: 50,
          default: 10
        }
      },
      required: ['query']
    }
  },

• src/http-server.ts:277-302 (registration)

  MCP tool registration in the HTTP server (http-server.ts), including name, description, and JSON input schema.

  {
    name: 'get_station_info',
    description: 'Get detailed information about a train station',
    inputSchema: {
      type: 'object',
      properties: {
        query: {
          type: 'string',
          description: 'Station name or code to search for',
        },
        includeNonPlannableStations: {
          type: 'boolean',
          description: 'Include stations where trains do not stop regularly',
          default: false
        },
        limit: {
          type: 'number',
          description: 'Maximum number of results to return',
          minimum: 1,
          maximum: 50,
          default: 10
        }
      },
      required: ['query']
    }
  },