search_places

Search for a location by name. Returns a list of matching places with addresses. Use this to find the pickup or dropoff location before booking a ride.

Parameters3

query	string	required	The place name or address to search for, e.g. "Lekki Phase 1" or "Murtala Muhammed Airport"
lat	number	optional	Optional latitude to bias results toward the user's area
lng	number	optional	Optional longitude to bias results toward the user's area

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The place name or address to search for, e.g. \"Lekki Phase 1\" or \"Murtala Muhammed Airport\""
    },
    "lat": {
      "type": "number",
      "description": "Optional latitude to bias results toward the user's area"
    },
    "lng": {
      "type": "number",
      "description": "Optional longitude to bias results toward the user's area"
    }
  },
  "required": [
    "query"
  ]
}

get_place_details

Get the exact coordinates and full address for a place using its place_id (returned from search_places). Call this after search_places to get lat/lng needed for fare estimates and booking.

Parameters1

place_id

string

required

The Google place_id from a search_places result

Raw schema

{
  "type": "object",
  "properties": {
    "place_id": {
      "type": "string",
      "description": "The Google place_id from a search_places result"
    }
  },
  "required": [
    "place_id"
  ]
}

get_fare_estimate

Get available vehicle types and fare estimates for a trip. Returns a list of vehicle options with prices, ETAs, and vehicle type IDs needed for booking.

Parameters6

pick_lat	number	required	Pickup latitude
pick_lng	number	required	Pickup longitude
drop_lat	number	required	Dropoff latitude
drop_lng	number	required	Dropoff longitude
pick_address	string	optional	Pickup address text
drop_address	string	optional	Dropoff address text

Raw schema

{
  "type": "object",
  "properties": {
    "pick_lat": {
      "type": "number",
      "description": "Pickup latitude"
    },
    "pick_lng": {
      "type": "number",
      "description": "Pickup longitude"
    },
    "drop_lat": {
      "type": "number",
      "description": "Dropoff latitude"
    },
    "drop_lng": {
      "type": "number",
      "description": "Dropoff longitude"
    },
    "pick_address": {
      "type": "string",
      "description": "Pickup address text"
    },
    "drop_address": {
      "type": "string",
      "description": "Dropoff address text"
    }
  },
  "required": [
    "pick_lat",
    "pick_lng",
    "drop_lat",
    "drop_lng"
  ]
}

book_ride

Book a Rovv ride. Requires pickup/dropoff coordinates, a vehicle_type ID (from get_fare_estimate), and payment method. Returns booking confirmation with ride number.

Parameters10

pick_lat	number	required	Pickup latitude
pick_lng	number	required	Pickup longitude
drop_lat	number	required	Dropoff latitude
drop_lng	number	required	Dropoff longitude
pick_address	string	required	Pickup address text
drop_address	string	required	Dropoff address text
vehicle_type	string	required	The zone_type_id from get_fare_estimate results
payment_opt	integer	optional	Payment method: 0 = card, 1 = cash, 2 = wallet
is_later	boolean	optional	Set to true for scheduled rides
trip_start_time	string	optional	For scheduled rides: datetime in Y-m-d H:i:s format

Raw schema

{
  "type": "object",
  "properties": {
    "pick_lat": {
      "type": "number",
      "description": "Pickup latitude"
    },
    "pick_lng": {
      "type": "number",
      "description": "Pickup longitude"
    },
    "drop_lat": {
      "type": "number",
      "description": "Dropoff latitude"
    },
    "drop_lng": {
      "type": "number",
      "description": "Dropoff longitude"
    },
    "pick_address": {
      "type": "string",
      "description": "Pickup address text"
    },
    "drop_address": {
      "type": "string",
      "description": "Dropoff address text"
    },
    "vehicle_type": {
      "type": "string",
      "description": "The zone_type_id from get_fare_estimate results"
    },
    "payment_opt": {
      "type": "integer",
      "description": "Payment method: 0 = card, 1 = cash, 2 = wallet",
      "default": 1
    },
    "is_later": {
      "type": "boolean",
      "description": "Set to true for scheduled rides",
      "default": false
    },
    "trip_start_time": {
      "type": "string",
      "description": "For scheduled rides: datetime in Y-m-d H:i:s format"
    }
  },
  "required": [
    "pick_lat",
    "pick_lng",
    "drop_lat",
    "drop_lng",
    "pick_address",
    "drop_address",
    "vehicle_type"
  ]
}

cancel_ride

Cancel an active ride. Optionally provide a reason.

Parameters2

request_id	string	optional	The ride request ID to cancel. If not provided, cancels the current active ride.
reason	string	optional	Optional cancellation reason

Raw schema

{
  "type": "object",
  "properties": {
    "request_id": {
      "type": "string",
      "description": "The ride request ID to cancel. If not provided, cancels the current active ride."
    },
    "reason": {
      "type": "string",
      "description": "Optional cancellation reason"
    }
  },
  "required": []
}

get_current_ride

Get the status of the user's current active ride, including driver details, ETA, and ride status.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

get_ride_history

Get the user's past ride history. Returns recent completed and cancelled rides.

Parameters1

limit

integer

optional

Number of rides to return (default 5, max 20)

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Number of rides to return (default 5, max 20)",
      "default": 5
    }
  },
  "required": []
}

get_route_info

Get driving route information between two points including distance, duration, and polyline.

Parameters4

pickup_lat	number	required	Pickup latitude
pickup_lng	number	required	Pickup longitude
drop_lat	number	required	Dropoff latitude
drop_lng	number	required	Dropoff longitude

Raw schema

{
  "type": "object",
  "properties": {
    "pickup_lat": {
      "type": "number",
      "description": "Pickup latitude"
    },
    "pickup_lng": {
      "type": "number",
      "description": "Pickup longitude"
    },
    "drop_lat": {
      "type": "number",
      "description": "Dropoff latitude"
    },
    "drop_lng": {
      "type": "number",
      "description": "Dropoff longitude"
    }
  },
  "required": [
    "pickup_lat",
    "pickup_lng",
    "drop_lat",
    "drop_lng"
  ]
}

Rovv - Book Rides in Africa

MCP Server: com.rovvafrica/ride-booking

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

search_places

get_place_details

get_fare_estimate

book_ride

cancel_ride

get_current_ride

get_ride_history

get_route_info

Install

Remote endpoint