DealerDirect South Florida New & Used Inventory MCP — Documentation

1. Quick Test with curl (Search New & Used Inventory)

curl -s -X POST "https://dealer-direct-mcp.web.app/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "search_inventory",
      "arguments": {
        "condition": "used",
        "body_style": "SUV",
        "price_max": 28000,
        "zip": "33140",
        "radius_miles": 25,
        "sort_by": "price",
        "limit": 5
      }
    }
  }'

2. All 5 MCP Tools & JSON Schemas

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Optional free-text search query (e.g., 'new SUV', 'used AWD', 'Ford Explorer', 'Honda Civic')."
    },
    "condition": {
      "type": "string",
      "enum": [
        "new",
        "used",
        "certified"
      ],
      "description": "Filter by vehicle condition ('new', 'used', or 'certified'). Omit to search all conditions."
    },
    "state": {
      "type": "string",
      "description": "2-letter US state code filter (e.g., 'FL', 'TX', 'GA', 'NC', 'AZ', 'CA', 'IL', 'MI', 'NJ')."
    },
    "city": {
      "type": "string",
      "description": "City name filter (e.g., 'Miami', 'Orlando', 'Tampa', 'Jacksonville', 'Atlanta', 'Austin', 'Houston', 'Phoenix')."
    },
    "region": {
      "type": "string",
      "description": "Regional market filter (e.g., 'South Florida', 'Central Florida', 'Tampa Bay', 'North Florida', 'Atlanta', 'Texas', 'Carolinas', 'West')."
    },
    "make": {
      "type": "string",
      "description": "Vehicle make (e.g., 'BMW', 'Toyota', 'Mazda', 'Tesla', 'Audi', 'Ford')."
    },
    "model": {
      "type": "string",
      "description": "Vehicle model (e.g., 'CX-30', 'Model Y', 'Camry', 'X2', '3 Series')."
    },
    "trim": {
      "type": "string",
      "description": "Vehicle trim or submodel (e.g., 'Long Range', 'xDrive28i', 'SE')."
    },
    "year_min": {
      "type": "integer",
      "description": "Minimum model year (e.g., 2020)."
    },
    "year_max": {
      "type": "integer",
      "description": "Maximum model year (e.g., 2026)."
    },
    "price_max": {
      "type": "number",
      "description": "Maximum advertised price in USD (e.g., 25000)."
    },
    "mileage_max": {
      "type": "integer",
      "description": "Maximum odometer mileage in miles (e.g., 60000)."
    },
    "zip": {
      "type": "string",
      "description": "5-digit US ZIP code for geo-radius search (e.g., '33140' for Miami Beach, '33169' for Miami Gardens)."
    },
    "radius_miles": {
      "type": "number",
      "description": "Search radius in miles from the ZIP centroid (default: 25, max: 500)."
    },
    "fuel_type": {
      "type": "string",
      "description": "Fuel type filter ('Gasoline', 'Hybrid', 'Electric', 'Plug-In Hybrid', 'Diesel')."
    },
    "drivetrain": {
      "type": "string",
      "description": "Drivetrain filter ('AWD', 'FWD', 'RWD', '4WD')."
    },
    "transmission": {
      "type": "string",
      "description": "Transmission filter (e.g., 'Automatic', 'Manual')."
    },
    "body_style": {
      "type": "string",
      "description": "Vehicle body style ('SUV', 'Sedan', 'Truck', 'Coupe', 'Convertible', 'Hatchback', 'Van')."
    },
    "certified_only": {
      "type": "boolean",
      "description": "If true, only return factory Certified Pre-Owned (CPO) vehicles."
    },
    "dealer_id": {
      "type": "string",
      "description": "Filter by specific dealer ID (e.g., 'dealer_north_miami_mitsubishi')."
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "price",
        "price_asc",
        "price_desc",
        "mileage",
        "distance",
        "newest"
      ],
      "description": "Sort order for results (default: 'price')."
    },
    "limit": {
      "type": "integer",
      "description": "Max vehicles to return per page (1-100, default: 20)."
    },
    "page": {
      "type": "integer",
      "description": "Page number for pagination (1-based, default: 1)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "id_or_vin": {
      "type": "string",
      "description": "The canonical vehicle ID (e.g., 'veh_north-miami-mitsubishi_...') or 17-character VIN (e.g., '3MVDMBBM7SM754223')."
    }
  },
  "required": [
    "id_or_vin"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "Optional 2-letter US state filter (e.g., 'FL', 'TX', 'GA', 'NC', 'AZ', 'CA', 'IL', 'MI', 'NJ')."
    },
    "region": {
      "type": "string",
      "description": "Optional regional market filter (e.g., 'South Florida', 'Orlando', 'Tampa Bay', 'Atlanta', 'Texas')."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "vehicle_id": {
      "type": "string",
      "description": "Vehicle ID or 17-character VIN the buyer is inquiring about."
    },
    "dealer_id": {
      "type": "string",
      "description": "Dealer ID (optional if vehicle_id is provided; required for general dealer inquiries)."
    },
    "buyer_name": {
      "type": "string",
      "description": "Full name of the prospective buyer."
    },
    "buyer_email": {
      "type": "string",
      "description": "Buyer's email address (at least one of buyer_email or buyer_phone is required)."
    },
    "buyer_phone": {
      "type": "string",
      "description": "Buyer's phone number (at least one of buyer_email or buyer_phone is required)."
    },
    "message": {
      "type": "string",
      "description": "Buyer's intent, questions, test-drive request, or trade-in/insurance notes."
    },
    "consent": {
      "type": "boolean",
      "description": "Explicit buyer consent flag. Must be true to create and deliver the lead to the dealership."
    }
  },
  "required": [
    "buyer_name",
    "consent"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "lead_id": {
      "type": "string",
      "description": "The unique lead ID returned by submit_lead."
    },
    "dealer_api_key": {
      "type": "string",
      "description": "Dealer API key for authentication."
    }
  },
  "required": [
    "lead_id",
    "dealer_api_key"
  ],
  "additionalProperties": false
}