movilidad-con-prompts

joaquinvalentin/movilidad-con-prompts

3.1

If you are the rightful owner of movilidad-con-prompts and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

Movilidad Con Prompts is an MCP server providing real-time and scheduled bus information for Montevideo's public transportation system.

Tools
3
Resources
0
Prompts
0

Movilidad Con Prompts - Montevideo Public Transport MCP Server

A Model Context Protocol (MCP) server that provides real-time and scheduled bus information for Montevideo, Uruguay's public transportation system. This server exposes three powerful tools for querying bus schedules, routes, and real-time arrival information.

Built for the "Build your MCP" Hackathon organized by Google Developers Groups Uruguay.

🚌 Available MCP Tools

1. consultar_horarios_programados_omnibus

Purpose: Query scheduled bus times near a specific address

Parameters:

  • direccion (string): Address in natural language (e.g., "18 de Julio 1234" or "Pocitos esquina Buxareo")
  • tiempo (optional string): Date and time in "YYYY-MM-DD HH:MM" format (defaults to current time)
  • radio (optional float): Search radius in meters (default: 200m)

Returns: Array of nearby bus stops with scheduled bus times, including:

  • Bus stop location (street intersection)
  • Scheduled departure times
  • Bus line numbers
  • Destinations
  • Minutes until arrival

Use Cases:

  • Planning trips with scheduled bus information
  • Finding bus stops near a location
  • Getting comprehensive schedule data for a specific time

2. consultar_rutas_omnibus

Purpose: Find bus routes between two addresses

Parameters:

  • direccionOrigen (string): Origin address ("street number" or "street esquina street")
  • direccionDestino (string): Destination address (same format)

Returns: Array of route options, each containing:

  • Sequence of route segments
  • Bus lines to take
  • Transfer points
  • Walking distances at origin and destination
  • Stop descriptions

Use Cases:

  • Trip planning between two locations
  • Finding optimal routes with transfers
  • Getting detailed walking instructions

3. consultar_eta_tiempo_real

Purpose: Get real-time estimated arrival times (ETAs) for buses at a specific stop

Parameters:

  • parada_id (integer): Bus stop ID (obtained from consultar_horarios_programados_omnibus)
  • lineas (optional array): Specific bus lines to query (e.g., ["181", "407"])

Returns: Real-time information including:

  • Bus line numbers
  • Destinations
  • ETA in minutes and seconds
  • Distance of approaching buses
  • Bus and company codes
  • GPS coordinates

Use Cases:

  • Real-time arrival information
  • Checking specific bus lines
  • Live tracking of approaching buses

Configuration

The server is configured to connect to Montevideo's public APIs:

  • Geocoding: https://direcciones.ide.uy/api/v0/geocode/BusquedaDireccion
  • Bus Schedules: https://api.montevideo.gub.uy/transporteRest/
  • Real-time ETAs: https://m.montevideo.gub.uy/stmonlineRest/
  • Route Planning: https://api.montevideo.gub.uy/comoirRest/

📋 Usage Examples

Finding Bus Schedules

# Get buses near Plaza Independencia at 2 PM today
result = consultar_horarios_programados_omnibus(
    direccion="Plaza Independencia",
    tiempo="2024-01-15 14:00",
    radio=300
)

Planning a Route

# Route from Pocitos to Ciudad Vieja
result = consultar_rutas_omnibus(
    direccionOrigen="Pocitos esquina Buxareo",
    direccionDestino="Ciudadela esquina 25 de Mayo"
)

Real-time Bus Tracking

# Check when the next 181 bus arrives at stop 1234
result = consultar_eta_tiempo_real(
    parada_id=1234,
    lineas=["181"]
)