# SPTrans Olho Vivo MCP for AI Agents AI Agent Connect > SPTrans Olho Vivo MCP provides real-time bus data for São Paulo. Use it to track active fleet positions, check arrival forecasts for specific stops, and find transit lines or corridors across the city. It brings live mobility intelligence directly into your AI agent. ## Overview - **Category:** data-analytics - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_7LC2d2RPTETrnyDTnxvd3pgzd3WkYlgNn47fk8kn/ai-agent-connect - **Tags:** public-transit, real-time-tracking, gps-data, urban-mobility, api-integration, transit-forecast ## Description SPTrans Olho Vivo connects your AI agent to the official São Paulo public transit feed. Instead of refreshing multiple tabs or checking different apps to see if your bus is coming, you can just ask your agent for the latest status. It pulls live GPS coordinates for the entire fleet, which means you can see exactly where vehicles are in the city. You can also get precise arrival forecasts for specific stops or entire lines, making it way easier to plan a commute on the fly. If you're looking for infrastructure details, it can list bus corridors, operating companies, and even show which vehicles are currently sitting in a garage. This Connector is part of the Vinkius catalog, making it easy to plug into your existing workflow so you can get transit answers in plain English. Whether you're trying to figure out a late bus or analyzing city-wide fleet distribution, the data is always fresh and ready for your agent to interpret. ## Tools ### get_forecast_by_stop Get arrival forecasts for all lines arriving at a specific stop. Use this to see which buses are coming to your current location. ### get_forecast Get arrival forecast for a specific stop and line. This gives you the exact time for a single bus on a specific route. ### get_positions_by_line Get real-time GPS positions for buses on a specific line. You can see exactly where every bus on a route is located right now. ### get_all_positions Get real-time GPS positions for all active buses. This gives you a city-wide view of the entire active fleet. ### list_companies List bus operating companies by area. This helps you identify which companies serve specific parts of the city. ### list_corridors List all intelligent bus corridors in São Paulo. Use this to see the primary transit arteries in the city. ### search_lines_by_direction Search for bus lines filtered by direction. This helps you find the right line heading where you need to go. ### search_stops_by_line Get all stops for a specific bus line. Use this to see every stop on a specific route. ### get_forecast_by_line Get arrival forecasts for all stops on a specific line. This helps you see the timing for an entire route. ### search_stops_by_corridor Get all stops in a specific intelligent corridor. This lets you see every stop along a major transit artery. ### get_positions_in_garage Get real-time GPS positions for buses currently in the garage. Use this to see which vehicles are currently out of service. ### search_lines Search for bus lines by number or name. Use this to find the correct line ID for your intended route. ### search_stops Search for bus stops by name or address. This helps you find the nearest stop to your current location. ## Prompt Examples **Prompt:** ``` Find the bus lines near Lapa. ``` **Response:** ``` I found several lines for 'Lapa', including line 8000-10 (Terminal Lapa) with code 33657. Would you like to see the current bus positions for this line? ``` **Prompt:** ``` What's the forecast for stop 650005666? ``` **Response:** ``` For stop 650005666, the next bus on line 8000-10 is expected in **5 minutes**. There is also a bus for line 8615-10 arriving in **12 minutes**. ``` **Prompt:** ``` Show me the positions of buses on line 33657. ``` **Response:** ``` There are currently **4 buses** active on line 33657: * Two are near Terminal Lapa * One is on Rua Clélia * One is approaching the city center ``` ## Capabilities ### Track active bus GPS coordinates See the real-time location of buses across the city or on specific routes. ### Get arrival forecasts for specific stops Find out exactly how many minutes remain until the next bus hits your stop. ### Locate bus lines by name or number Search the transit network to find the correct line for your destination. ### Identify bus corridors and operating companies Get a clear picture of the city's transit infrastructure and who runs it. ### Check if vehicles are currently in a garage See which buses are offline for maintenance or storage. ### Find all stops along a specific transit line Get a full list of every stop served by a particular bus route. ## Use Cases ### Late bus check A commuter asks if a specific bus is running late, and the agent provides a 5-minute update based on live GPS data. ### Route planning A traveler asks for all stops on a line, and the agent lists them out to help them navigate the city. ### Fleet analysis A researcher asks for the location of every active bus to see how many are in the city center right now. ### Infrastructure audit A planner asks for the list of intelligent corridors to review the city's transit arteries and coverage. ## Benefits - Stop guessing bus times by checking the exact arrival forecast for your specific stop. - See the full city fleet at once to understand traffic flow across the metro area. - Plan your route better by seeing every stop on a specific line. - Identify local transit infrastructure by listing corridors and operating companies. - Monitor maintenance status by checking which vehicles are currently in the garage. ## How It Works The bottom line is you get real-time São Paulo transit data through a natural conversation with your agent. 1. Subscribe to the SPTrans Olho Vivo MCP in the Vinkius catalog. 2. Add your SPTrans Olho Vivo API Token to your configuration. 3. Ask your AI client to check bus positions or arrival times. ## Frequently Asked Questions **Can I use SPTrans Olho Vivo to see live bus locations?** Yes, it provides real-time GPS coordinates for the active fleet in São Paulo. **Does SPTrans Olho Vivo work for all of Brazil?** No, this Connector is specifically for the São Paulo public transit system. **How can I check arrival times for my stop with SPTrans Olho Vivo?** You can ask your agent for the arrival forecast of any specific stop in the city. **Can I see which companies operate in different areas using SPTrans Olho Vivo?** Yes, the Connector can list bus operating companies based on their specific service areas. **Can I find all the stops on a specific bus line?** Yes, you can ask the agent to list every stop served by a particular bus line number or name. **Is SPTrans Olho Vivo good for urban planning research?** Yes, it allows you to pull data on corridors and live fleet distribution for city-wide analysis. **How do I find the specific code for a bus line?** Use the `search_lines` tool with the line number or name (e.g., '8000' or 'Lapa'). The agent will return the line code (`cl`), which is required for tracking positions or forecasts. **Can I see the arrival times for all buses at a particular stop?** Yes! Use the `get_forecast_by_stop` tool with the stop code (`cp`). It will list all upcoming bus arrivals for that location in real-time. **Is it possible to track the live location of buses on a map?** While the Connector returns raw coordinates, you can use `get_positions_by_line` to get the latitude and longitude of every active bus on a line, which your AI can then describe or plot.