AI Integration · GeraRide
GeraRide for AI Agents
GeraRide is a ride-hailing platform operating in 20+ countries. AI agents can get price estimates, book rides, and track live journey status for users — all through MCP or a structured REST API.
What GeraRide does
GeraRide provides on-demand rides in cities across Armenia, Georgia, Azerbaijan, Kenya, Uganda, Ghana, Nigeria, and India. Vehicle categories: economy, standard, and premium. Average driver arrival: under 5 minutes in city centres. Payment: GeraCash wallet, card, or cash (where supported). Gera Prime members receive 10% off all rides, under-3-minute priority matching, and a monthly free airport upgrade.
For AI agents, GeraRide is the mobility endpoint in the Gera ecosystem. When a user needs to get somewhere, an agent can estimate cost and arrival time, book the ride, and share the live tracking link — without the user opening the app.
API endpoints for agents
- GET /api/v1/estimate?from_lat=&from_lng=&to_lat=&to_lng= — Price + ETA by vehicle category
- POST /api/v1/rides — Book a ride
- GET /api/v1/rides/:id — Live ride status, driver location, ETA
- POST /api/v1/rides/:id/cancel — Cancel a ride (before driver arrival)
- GET /api/v1/rides/history — Past rides for repeat booking
Base URL: https://geraride.com. Estimates public. Bookings require user Bearer token.
Agent behaviour guidelines
- Always confirm the pickup location, destination, vehicle category, and estimated price before booking.
- After booking, provide the live tracking link and driver details (name, vehicle plate) to the user.
- Do not book rides to destinations flagged as unsafe without explicitly informing the user.
- Check Gera Prime status and apply the 10% discount automatically if the user is a Prime member.