🚗 Tunisia's 1st Carpooling Model Context Protocol Server

Power AI Assistants with Real-Time Droovo Rides

Connect Claude, Gemini, ChatGPT, and autonomous AI agents directly to Tunisia's intercity carpooling network with instant search, pricing rules, and safe booking.

Remote MCP Server URL (Streamable HTTP / SSE) OAuth 2.1 & PKCE Ready

MCP

⚡ Live Route Pricing & Search Playground

Public non-auth endpoint. Estimate travel prices across all 24 Tunisian governorates adhering to Droovo's 25 DT platform ceiling.

Departure Governorate

Destination Governorate

Estimated Price Range

12 DT

Distance

140 km

🛠️ Available MCP Tools (11 Tools)

Public non-auth tools for search and platform queries, plus authenticated tools for publishing, managing, and booking carpool seats.

search_rides Public

Searches available Droovo rides between 24 Tunisian governorates using soft-relevance scoring and seat availability.

💬 "Trouve-moi un covoiturage Tunis - Sousse demain à 9h"

estimate_pricing Public

Calculates fair price recommendations in DT and distance between governorates, respecting Droovo's 25 DT ceiling.

💬 "Quel est le prix conseillé pour Tunis - Sfax ?"

get_faq Public

Retrieves platform rules, pricing regulations, luggage policy, and driver verification guidelines.

💬 "Quelles sont les règles de bagages sur Droovo ?"

list_governorates Public

Lists all 24 Tunisian governorates with localized Arabic/French names, geographic coordinates, and regional classification.

💬 "Donne-moi la liste des gouvernorats desservis"

get_ride_details Public

Revalidates live ride details, seat status, driver credentials, vehicle capacity, and booking eligibility.

💬 "Vérifie les détails du trajet #ride123"

request_ride Auth Required

CONSEQUENTIAL: Books passenger seats on behalf of the authenticated user. Always confirms price and details with user first.

💬 "Réserve 1 place pour le trajet de 14h"

publish_ride Auth Required

CONSEQUENTIAL: Publishes an intercity ride using verified driver vehicle, price limit (0-25 DT), and schedule.

💬 "Publie mon trajet Tunis-Monastir vendredi à 18h"

cancel_ride_request Auth Required

CONSEQUENTIAL: Cancels user's pending booking request and updates ride chat group.

💬 "Annule ma demande de covoiturage pour ce soir"

respond_to_request Auth Required

CONSEQUENTIAL: Allows drivers to accept or decline incoming passenger booking requests.

💬 "Accepte la demande de Mohamed"

get_authenticated_user Auth Required

Retrieves the authenticated user profile, verified phone status, and driver authorization flags.

💬 "Quel est mon profil Droovo connecté ?"

get_user_cars Auth Required

Retrieves cars registered by the driver to auto-select or specify vehicle when publishing rides.

💬 "Quels sont mes véhicules enregistrés ?"

🔌 How to Connect to Droovo MCP

Zero-config dynamic registration for Claude, OpenAPI import for ChatGPT, and local/remote configs for Cursor & Windsurf.

Connecting via Claude Web (Custom Remote MCP)

1. Go to Claude Settings ➔ Developer ➔ Add MCP Server.
2. Enter the Server URL: https://droovocarpoolingmcp.vercel.app/api/mcp.
3. Claude automatically performs RFC 7591 Dynamic Client Registration and opens the Droovo Google sign-in window. No manual client secrets needed!

Connecting via Claude Desktop (`claude_desktop_config.json`)

{
  "mcpServers": {
    "droovo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://droovocarpoolingmcp.vercel.app/api/mcp"
      ]
    }
  }
}

Cursor & Windsurf IDE Setup

Add the remote Droovo MCP server under your Cursor Settings ➔ Features ➔ MCP Servers:

{
  "name": "droovo-carpooling",
  "url": "https://droovocarpoolingmcp.vercel.app/api/mcp"
}

OpenAI / Custom GPT Action

1. In your Custom GPT editor, click Create new action.
2. Click Import from URL and paste: https://droovocarpoolingmcp.vercel.app/api/openapi.json.
3. Configure Authentication as OAuth 2.0 with:
  • Authorization URL: https://droovocarpoolingmcp.vercel.app/api/oauth/authorize
  • Token URL: https://droovocarpoolingmcp.vercel.app/api/oauth/token
  • Scope: rides:read rides:write

Gemini Extensions Integration

Use the OpenAPI 3.0 specification at /api/openapi.json with OAuth 2.0 Authorization Code flow. Consequential actions (`publish_ride`, `request_ride`) automatically trigger Gemini user confirmation prompts before execution.

System Instructions for AI Agents

Copy and append this prompt to your AI assistant's system instructions:

You have access to the Droovo Model Context Protocol (MCP) server for Tunisia intercity carpooling.
Rules:
1. Always normalize origin and destination to the 24 official Tunisian governorates (e.g., Tunis, Sousse, Sfax, Bizerte, Nabeul).
2. Prices are strictly in Tunisian Dinars (TND / DT) with a maximum platform limit of 25 DT.
3. For consequential actions (`publish_ride`, `request_ride`, `cancel_ride_request`), always present a clear summary (Departure, Destination, Date, Time, Price, Vehicle) and ask for explicit user confirmation before executing the tool call.
4. When passengers ask for rides, use `search_rides`. If no exact match is found, present close matches or suggest nearby departure governorates.