🚚 FleetMind MCP Server

Enterprise Model Context Protocol Server for AI-Powered Delivery Dispatch

MCP 1st Birthday Hackathon Track 1: Building MCP Enterprise Category

🔌 MCP Server Connection

SSE Endpoint URL:
https://mcp-1st-birthday-fleetmind-dispatch-ai.hf.space/sse

🔑 Step 1: Get Your API Key

Generate API Key →

Click the button above to generate your unique API key. You'll need this to authenticate with the server.

⚙️ Step 2: Configure Claude Desktop

Add this to your claude_desktop_config.json file:

{
  "mcpServers": {
    "fleetmind": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp-1st-birthday-fleetmind-dispatch-ai.hf.space/sse?api_key=fm_your_api_key_here"
      ]
    }
  }
}

💡 Important: Add your API key as a query parameter (?api_key=...) in the URL, not in the env section!

📋 Step 3: Connect

Generate your API key using the button above
Install Claude Desktop
Locate your claude_desktop_config.json file
Add the configuration, replacing fm_your_api_key_here with your actual API key in the URL
Restart Claude Desktop
Look for "FleetMind" in the 🔌 tools menu

🛠️ Available Tools (29 Total)

📍 Geocoding & Routing (3 tools):
geocode_address, calculate_route, calculate_intelligent_route

📦 Order Management (8 tools):
create_order, count_orders, fetch_orders, get_order_details, search_orders, get_incomplete_orders, update_order, delete_order

👥 Driver Management (8 tools):
create_driver, count_drivers, fetch_drivers, get_driver_details, search_drivers, get_available_drivers, update_driver, delete_driver

🔗 Assignment Management (8 tools):
create_assignment, auto_assign_order, intelligent_assign_order, get_assignment_details, update_assignment, unassign_order, complete_delivery, fail_delivery

🗑️ Bulk Operations (2 tools):
delete_all_orders, delete_all_drivers

⭐ Key Features

🔑 API Key Authentication - Secure multi-tenant access with personal API keys (URL-based)
👥 Multi-Tenant Isolation - Complete data separation via user_id (deterministic from email)
🧠 Gemini 2.0 Flash AI - Intelligent order assignment with detailed reasoning
🌦️ Weather-Aware Routing - Safety-first delivery planning with OpenWeatherMap
🚦 Real-Time Traffic - Google Routes API integration with live traffic data
📊 SLA Tracking - Automatic on-time performance monitoring
🗄️ PostgreSQL Database - Production-grade data storage with user_id filtering (Neon)
🚀 Multi-Client Support - Works with Claude Desktop, Continue, Cline, any MCP client

🔒 Authentication & Security

How Authentication Works:
1. Generate API key via /generate-key
2. API key hashed (SHA-256) before storage
3. User ID generated: user_{MD5(email)[:12]}
4. Add key to URL: ?api_key=fm_...
5. Server validates on each SSE connection
6. All queries filter by user_id for isolation

Security Features:
✅ One-Time Display (keys shown once)
✅ Hashed Storage (SHA-256, never plaintext)
✅ Database-Level Isolation (all tables have user_id)
✅ Deterministic User IDs (same email → same user_id)
✅ Production Safeguards (ENV-based SKIP_AUTH protection)

📚 Resources

GitHub: mashrur-rahman-fahim/fleetmind-mcp
HuggingFace Space: MCP-1st-Birthday/fleetmind-dispatch-ai
MCP Protocol Docs: modelcontextprotocol.io

FleetMind v1.0 - Built for MCP 1st Birthday Hackathon
29 AI Tools | 2 Real-Time Resources | Enterprise-Ready